重要なポイント
- 領収書は支払いの証明であり、税務上の請求書ではありません。付加価値税の請求書などは販売者であるお客様が発行してください。領収書ページにも明記されます。
- 注文作成時に receipt_email を渡すと、支払い後に一度だけ領収書メールが送信されます。locale（zh または en）は決済画面、領収書ページ、メールの言語を決めます。
- POST /v1/orders/{trade_no}/send_receipt で送信または再送信します。email は任意で、注文の receipt_email として保存されます。未払いの注文は 409 conflict、1 注文あたり 1 時間に 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"
}'