---
title: "Dedicated Error Code for Insufficient Refund Balances"
description: "The refund endpoint now returns an insufficient_balance error code when your account does not have enough funds to cover a refund."
date: "2026-09-04"
url: "https://docs.komoju.com/en/changelog/insufficient-balance-refund-error"
source_url: "https://docs.komoju.com/en/changelog/insufficient-balance-refund-error.md"
language: en
---

## What Changed

If your account does not have enough unsettled funds to cover a refund request, `POST /api/v1/payments/{id}/refund` now returns an HTTP 400 error with the code `insufficient_balance`. Previously, this case returned a generic error.

## Developer Impact

Your integration can detect `insufficient_balance` and handle it programmatically, for example by alerting your finance team or topping up your reserve. Because the error code is specific, you can tell a balance shortfall apart from a gateway timeout.