핵심 사항
- 영수증은 결제 증빙이며 세금계산서가 아닙니다. 부가가치세 계산서 등 세무 서류는 판매자인 가맹점이 직접 발행해야 하며, 영수증 페이지에도 이를 안내합니다.
- 주문 생성 시 receipt_email을 전달하면 결제 후 영수증 이메일이 한 번 자동 발송됩니다. locale(zh 또는 en)은 결제 화면, 영수증 페이지, 이메일의 언어를 정합니다.
- POST /v1/orders/{trade_no}/send_receipt로 발송하거나 재발송합니다. email은 선택 사항이며 주문의 receipt_email로 저장됩니다. 미결제 주문은 409 conflict, 주문당 시간당 5회를 넘으면 429 rate_limited입니다.
- 결제된 주문에는 receipt_url(서명된 장기 링크), receipt_number, receipt_email, receipt_sent_at, locale이 있습니다. 답장은 가맹점 등록 연락처 이메일로 가며, 샌드박스 영수증에는 [TEST]가 붙습니다.
예시
bash
curl -X POST "https://api.kukopay.com/v1/orders" \
-H "Content-Type: application/json" \
-H "X-Api-Key: $KUKOPAY_API_KEY" \
-d '{
"amount": 2990,
"currency": "USD",
"subject": "Premium plan",
"receipt_email": "[email protected]",
"locale": "en"
}'