Refunds

A refund returns money from a completed collection to the original payer. The refund amount is debited from your business wallet.

Rules

Full or partial: choose FULL (entire net amount) or PARTIAL (custom amount up to net amount)
One refund only: each collection can only be refunded once — there is no second refund after a partial refund
Non-refundable fee: the original collection processing fee is not returned; the maximum refundable amount is the net amount
Reason required: use a predefined reason code from GET /refunds/reasons

Statuses

Status	Description
`PENDING`	Processing
`COMPLETED`	Successfully refunded
`FAILED`	Failed to process

Fees

No additional fee is charged to process a refund. The original collection fee is simply not returned to you.

Original Amount	Collection Fee	Net Received	Max Refundable
$100.00	$3.00	$97.00	$97.00

Best Practices

Choose mode carefully: you only get one refund per collection — decide whether partial or full is appropriate before submitting
Check wallet balance: ensure your business wallet has sufficient funds before issuing a refund
Communicate: notify your customer once the refund.completed webhook is received

Error Codes

Code	Cause	Resolution
`ALREADY_REFUNDED`	Collection already has a refund	Only one refund is allowed per collection
`INVALID_STATUS`	Collection is not `COMPLETED`	Only completed collections can be refunded
`INSUFFICIENT_BALANCE`	Wallet balance too low	Top up your business wallet

Endpoints

POST /collections/{id}/refund — Create refund
GET /refunds — List refunds
GET /refunds/reasons — Get available refund reason codes