링크페이 생성
고객에게 간편 결제 URL을 전송하고, 실시간으로 결제 진행 상태를 확인할 수 있는 링크페이를 생성합니다.
비회원 주문, 전화/문자 기반 주문, 수기 견적 등 다양한 상황에서 활용됩니다.
POST
https://api.bootapi.com/v1/invoices
링크페이 생성 방식
- 금액 입력 - 상품 없이 금액만 입력하여 빠르게 생성
- 상품 선택 - 미리 등록된 상품을 선택하여 생성
사전 준비
링크페이 생성 전 결제 대상 고객 정보를 먼저 등록해야 합니다. (이메일, 휴대폰 번호, 이름 등)
생성 후 처리 흐름
- 1 결제 안내 메시지 발송 (이메일, SMS, 알림톡)
- 2 고객이 링크 클릭 후 결제 진행
- 3 결제 완료 시 Webhook으로 결과 전달
- 4 고객에게 완료 알림 발송
1
Server
SDK 설치
서버에서 API를 호출하기 위해 Backend SDK를 설치합니다.
SDK 설치 및 설정 방법은 토큰 발급 가이드를 참고하세요.
2
Server
링크페이 생성
Invoice 모델 데이터를 담아 API를 호출합니다.
요청 파라미터
| 파라미터 | 타입 | 필수 | 설명 |
|---|---|---|---|
invoice | object | 필수 | Invoice 모델 데이터 |
name | string | 필수 | 링크페이 이름 |
price | number | 필수 | 결제 금액 |
user_id | string | 필수 | 고객 ID |
products | array | 상품 목록 (선택) | |
expired_at | string | 만료일시 (ISO 8601) | |
metadata | object | 추가 메타데이터 |
3
Server
응답 처리
생성된 링크페이 정보가 반환됩니다.
응답 데이터
| 파라미터 | 타입 | 설명 |
|---|---|---|
id | string | 생성된 링크페이 ID |
invoice_id | string | 링크페이 번호 |
payment_url | string | 결제 페이지 URL |
client_key | string | 커머스 클라이언트 키 |
payment_url 활용
반환된 payment_url을 고객에게 전송하면 결제 페이지로 바로 이동할 수 있습니다.
