付款收据

每笔支付成功的订单都有一张付款收据：一个带编号、可打印或保存为 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，决定收银台的默认语言以及收据页面和收据邮件的语言。不传时，收银台和收据页跟随买家浏览器的语言，收据邮件使用中文。

手动发送或重发

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] 前缀，并注明未产生真实扣款。

订单上的收据字段

收据页面会显示订单退款后的已退金额，所以退款后仍然可以使用同一个链接。