링크페이 재발송 | Bootpay 커머스 매뉴얼

미결제 링크를 다시 보내 수납 흐름을 끊기지 않게 이어져요.

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

API 엔드포인트

POSThttps://api.bootapi.com/v1/invoices/:invoice_id/notifyBasic Auth

알림 유형

값	채널	설명
`PROCESS_DUPLICATED`	이미 처리된 요청이에요	휴대폰 문자 메시지 발송
2	알림톡 (카카오)	카카오 알림톡 발송
3	이메일	이메일 발송
4	앱 푸시	앱 푸시 알림 발송

notify_types에 여러 값을 전달하면 동시에 여러 채널로 발송할 수 있어요. 예: [2, 3]

요청 파라미터

파라미터	타입	필수	설명
`invoice_id`	String	필수	링크페이 ID (URL 파라미터)
`notify_types`	Array	필수	알림 유형 배열 (1: 문자, 2: 알림톡, 3: 이메일, 4: 앱푸시)

코드 예제

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

from bootpay_backend.commerce import BootpayCommerce

commerce = BootpayCommerce('{client_key}', '{secret_key}')
response = commerce.invoice_notify(
    '687a1b2c3d4e5f6789012345',
    [2, 3]  # 알림톡, 이메일
)
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
$response = $commerce->invoice->notify(
    '687a1b2c3d4e5f6789012345',
    [2, 3]  // 알림톡, 이메일
);
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import java.util.Arrays;

TokenPayload tokenPayload = new TokenPayload("{client_key}", "{secret_key}");
BootpayStore commerce = new BootpayStore(tokenPayload);
var response = commerce.invoice.notify(
    "687a1b2c3d4e5f6789012345",
    Arrays.asList(2, 3)  // 알림톡, 이메일
);
System.out.println(response.getData());java

commerce = BootpayStore::Api.new('{client_key}', '{secret_key}')
response = commerce.invoice_notify(
    '687a1b2c3d4e5f6789012345',
    [2, 3]  # 알림톡, 이메일
)
puts responseruby

commerce := bootpay.NewCommerceApi("{client_key}", "{secret_key}")
response, err := commerce.Invoice.Notify(
    "687a1b2c3d4e5f6789012345",
    []int{2, 3},  // 알림톡, 이메일
)
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("{client_key}", "{secret_key}");
var response = await commerce.Invoice.Notify(
    "687a1b2c3d4e5f6789012345",
    new int[] { 2, 3 }  // 알림톡, 이메일
);
Console.WriteLine(response);csharp

응답

성공 응답

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

에러 응답

{
  "status": 400,
  "code": 2005,
  "message": "링크페이 정보가 없습니다.",
  "data": null
}json

에러 코드

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

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