결제 링크 생성

서버에서 REST API로 결제 링크를 생성하면, 고객에게 자동으로 알림이 전송됩니다.

주문서 요청과 마찬가지로 일반 상품, 구독 상품 등을 쉽게 결제 링크로 전송할 수 있습니다. 링크 생성 시 고객의 email, phone 정보를 함께 전달하면, 알림 설정에 따라 이메일, 알림톡(카카오), 문자(SMS) 등으로 고객에게 자동 발송됩니다. 고객이 링크를 통해 결제를 완료하면 redirect_url로 이동합니다.

결제 링크 생성

Server

서버에서 부트페이 API를 호출하여 결제 링크를 생성합니다. 상품 정보와 결제 금액을 포함하여 요청합니다.

결제 링크는 일정 시간이 지나면 만료됩니다. 만료 시간을 설정하여 보안을 강화하세요.

API 요청 파라미터

name주문명 (예: "Professional 플랜")
price결제 금액
order_id가맹점 주문 고유 ID
redirect_url결제 완료 후 이동할 URL
use_notificationtrue - 알림 발송 여부 (true로 설정해야 링크가 전송됩니다)
user.email고객 이메일 (이메일 발송에 필요)
user.phone고객 전화번호 (SMS/알림톡 발송에 필요)

products 배열

구독할 상품 정보를 배열로 전달합니다.

product_idCommerce에 등록된 상품 ID
duration구독 기간 (-1은 무기한)
quantity수량

고객에게 자동 알림 발송

Server

결제 링크가 생성되면 알림 설정에 따라 고객에게 자동으로 발송됩니다. 단, use_notification: true로 설정해야 알림이 발송됩니다.

자동 알림 발송: use_notification: true 설정 시, 고객 정보(email, phone)가 있으면 이메일, SMS, 카카오 알림톡으로 자동 전송됩니다. 부트페이 관리자에서 알림 채널을 설정할 수 있습니다.

응답 데이터

payment_url결제 페이지 URL (직접 전송이 필요한 경우 활용)
invoice_id생성된 청구서 ID
expired_at링크 만료 시간

고객 결제 완료

Client

고객이 알림으로 받은 결제 링크를 클릭하면 주문서 페이지로 이동합니다. 결제 정보를 입력하고 결제를 완료합니다.

결제 결과 확인

Server

결제 링크를 발송하면 가맹점에서 별도로 검증할 필요 없이, 결제 결과를 확인하기만 하면 됩니다.

웹훅으로 결과 수신

결제가 완료되면 부트페이에서 설정된 웹훅 URL로 결제 결과를 전송합니다.

웹훅 URL은 부트페이 관리자에서 설정할 수 있습니다.

부트페이 관리자에서 확인

부트페이 관리자 페이지에서 결제 내역을 직접 확인할 수도 있습니다.

고급 기능

링크 만료 시간 설정

결제 링크의 유효 기간을 설정할 수 있습니다.

예시

expired_at: '2024-12-31 23:59:59'  // 만료 시간
// 또는
expire_in: 3600  // 초 단위 (1시간)

metadata 활용

결제에 추가 정보를 저장할 수 있습니다.

예시

metadata: {
  order_id: 'ORDER_123',
  plan_key: 'pro',
  billing_type: '연간',
  promotion_code: 'SUMMER2024'
}

웹훅 설정

웹훅 URL은 부트페이 관리자에서 설정합니다.

웹훅 실패 시 자동으로 재시도됩니다. 200 응답을 반환해야 성공으로 처리됩니다.

Server