Docs
ドキュメントAPIエクスプローラー
API2026年9月4日

残高不足による返金失敗に専用エラーコードを追加

Markdownで表示

What Changed

アカウントの未精算残高が返金リクエストの金額に満たない場合、POST /api/v1/payments/{id}/refund はコード insufficient_balance を含むHTTP 400エラーを返すようになりました。これまでは、このケースでは汎用エラーが返されていました。

Developer Impact

insufficient_balance を検知してプログラムで処理できるため、経理担当者への通知やリザーブの補填といった対応を実装できます。また、専用のエラーコードにより、残高不足とゲートウェイのタイムアウトを区別できます。