링크페이

링크페이 재발송

이 API 는 지금 동작하지 않아요. 재발송은 관리자 콘솔에서 해요.

이미 생성된 링크페이를 고객에게 다시 전송해요. 문자, 알림톡, 이메일, 앱푸시 등 다양한 채널로 결제 안내를 재발송할 수 있어요.

API 엔드포인트

POSThttps://api.bootapi.com/v1/invoices/:invoice_id/notifyBasic Auth
알려진 문제 — 재발송 API 가 지금 동작하지 않아요

지금은 이 API 를 부르면 발송 없이 SERVER_ERROR(HTTP 500)가 돌아와요. 재발송은 관리자 콘솔의 링크페이 목록에서 「재발송」으로 하거나, 링크 생성 때 use_notification: true 로 처음부터 발송해요.

알림 유형 (send_types)

send_types 배열에 넣는 값이에요. 숫자​​로 보내요.

값 채널 설명
1 알림톡 (카카오) 카카오 알림톡 발송
2 문자 SMS/LMS 문자 메시지 발송
3 이메일 이메일 발송

여러 값을 전달하면 동시에 여러 채널로 발송할 수 있어요. 예: [1, 3] 은 알림톡과 이메일을 함께 보내요.

표에 없는 값은 무시돼요

발송에 쓰이는 값은 위 세 개뿐이에요. 그 밖의 값을 넣으면 오류 없이 조용히 걸러져요 — 아무 데도 발송되지 않으니 오타에 주의해요.

요청 파라미터

파라미터 타입 필수 설명
invoice_id String 필수 링크페이 ID (URL 파라미터)
send_types Array 필수 알림 유형 배열 (1: 알림톡, 2: 문자, 3: 이메일 — 위 표 참고)

코드 예제

const { BootpayCommerce } = require('@bootpay/backend-js');

const commerce = new BootpayCommerce({
    client_key: '{client_key}',
    secret_key: '{secret_key}'
});

const response = await commerce.invoice.notify(
    '687a1b2c3d4e5f6789012345',
    [2, 3]  // 문자, 이메일
);
console.log(response);javascript

응답

성공 응답

{
  "status": 200,
  "message": "발송이 완료되었습니다."
}json

에러 응답

HTTP 상태 코드(404)는 헤더로 오고, 본문에는 코드 이름이 문자열로 와요.

{
  "error_code": "INVOICE_NOT_FOUND",
  "message": "링크페이 정보가 없습니다"
}json

에러 코드

공통 에러

인증·권한 관련 에러는 에러 코드표를 참고해요.

코드 메시지 대처 방법
INVOICE_NOT_FOUND 링크페이 정보가 없어요 invoice_id를 확인해요
INVOICE_DENIED 링크페이 정보에 조회권한이 없는 회원세션이에요 올바른 API 키를 사용하고 있는지 확인해요