Skip to main content
POST
Refund the unused prepaid balance

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

checkfu-version
enum<string>
required
Available options:
2026-08-31
idempotency-key
string
required
Required string length: 1 - 255

Body

application/json
reason
enum<string>
required

Why the balance is refunded. Only closure is offered: the unused balance is refunded in whole cents and fenced from spending until the payout completes.

Available options:
account_closure

Response

Success

refund_id
string
required
reason
enum<string>
required
Available options:
account_closure
amount_minor_units
integer
required
Required range: -9007199254740991 <= x <= 9007199254740991
currency
enum<string>
required
Available options:
usd
state
enum<string>
required
Available options:
pending,
paid,
failed
created_at
string
required