---
title: "残高不足による返金失敗に専用エラーコードを追加"
description: "アカウントの残高が返金額に満たない場合、返金エンドポイントがエラーコード insufficient_balance を返すようになりました。"
date: "2026-09-04"
url: "https://docs.komoju.com/ja/changelog/insufficient-balance-refund-error"
source_url: "https://docs.komoju.com/ja/changelog/insufficient-balance-refund-error.md"
language: ja
---

## What Changed

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

## Developer Impact

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