クイックスタート

重要なポイント

• 加盟店アカウントを登録し、kuko_test_ キーを取得して X-Api-Key ヘッダーに設定します。
• payment.succeeded、payment.failed、payment.expired を受信する公開 HTTPS のテスト用 Webhook を設定します。まだ用意できない場合は注文・イベント照会から始められます。
• 一意の out_trade_no、整数の amount、currency で POST /v1/orders を呼び、購入者を checkout_url へ転送します。URL の token をログに残さないでください。
• 生のリクエスト本文で Webhook 署名を検証し、イベント ID で重複を除外します。通知が遅れる場合は注文を照会します。
• 本番では加盟店審査を完了し、kuko_live_ キーと本番用 Webhook を設定するか、公開 HTTPS の notify_url を渡します。

例

curl -X POST "https://api.kukopay.com/v1/orders" \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: $KUKOPAY_API_KEY" \
  -d '{"out_trade_no":"ORD_20260921_0001","amount":2990,"currency":"USD","subject":"Test order"}'