返金を作成
POST /v1/refunds で支払済み注文の全額または一部を返金し、GET /v1/refunds/{refund_no} で状態を照会します。
重要なポイント
- trade_no は元の注文を示します。本番の返金には冪等キーとなる out_refund_no が必要です。
- amount は最小通貨単位の任意の正の整数です。省略すると返金可能な残額をすべて返します。
- 返金は非同期の場合があります。pending、succeeded、failed を確認し、署名付き返金イベントで確定を判断してください。
例
bash
curl "https://api.kukopay.com/v1/refunds/REF_20260921_0001" \
-H "X-Api-Key: $KUKOPAY_API_KEY"