付款收據

每筆支付成功的訂單都有一張付款收據：一個帶編號、可打印或保存為 PDF 的頁面，買家可以用它證明自己付過款。收據可以在支付成功時自動發給買家，也可以之後由你手動發送或重發。

支付成功後自動發送

下單時傳入買家郵箱 receipt_email，訂單支付成功後平台自動發出收據郵件，每筆訂單只自動發送一次：

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"
  }'

locale 可選 zh 或 en，決定收銀台的默認語言以及收據頁面和收據郵件的語言。不傳時，收銀台顯示英文（可用 checkout_url 上的 &locale= 指定），收據頁面和收據郵件使用買家付款時收銀台顯示的語言；沒有經過收銀台的訂單為英文。收據鏈接末尾追加 &locale=（zh、en、ja、ko、de）可臨時切換頁面語言。

手動發送或重發

POST https://api.kukopay.com/v1/orders/{trade_no}/send_receipt

curl -X POST "https://api.kukopay.com/v1/orders/ORD_20260921_0001/send_receipt" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KUKOPAY_API_KEY" \
  -d '{ "email": "[email protected]" }'

• email 可省略，默認發到訂單的 receipt_email；傳入的新地址會保存為訂單的 receipt_email。
• 只有已支付（包括之後部分或全額退款）的訂單有收據，未支付的訂單返回 409 conflict。
• 同一訂單每小時最多發送 5 次，超出返回 429 rate_limited。

控制台的訂單詳情頁也可以查看收據、發送或重發收據。

收據郵件

• 郵件以 KukoPay 的名義發出，標題和正文使用你在「商戶名稱與品牌」中設置的對外展示名稱。
• 郵件的回覆地址是你的入駐聯繫郵箱，買家直接回復就能聯繫到你。
• 沙箱訂單的收據標題帶 [TEST] 前綴，並註明未產生真實扣款。

訂單上的收據字段

收據頁面會顯示訂單退款後的已退金額，所以退款後仍然可以使用同一個鏈接。