​

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

​

Fees

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

​

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

​

Endpoints

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