Refunds

List refunds

GET/v1/refunds

Parameters

statusstringin query: One of pending_approval, approved, processing, succeeded, failed, rejected, cancelled, manual_required.
limitintegerin query: Default 25.
starting_afterstringin query
payment_intent_idstringin query

Responses

200Newest first
400Invalid request
401Missing, invalid or revoked API key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.

{ "object": "list", "data": [ { "id": "mo_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "object": "refund", "livemode": false, "status": "pending_approval", "amount": 125000, "currency": "KES", "payment_intent_id": "pay_01JB8Q4Z2N5V7K3M9P6R0T1W8X", "reason": "reason", "provider_ref": "provider ref", "failure_code": "failure code", "failure_message": "failure message", "attempts": [ { "attempt": 1, "channel": "api", "status": "pending", "provider_ref": "provider ref", "provider_code": "provider code", "provider_message": "provider message", "started_at": "2026-10-22T09:30:00.000Z", "finished_at": "2026-10-22T09:30:00.000Z" } ], "created_at": "2026-10-22T09:30:00.000Z", "completed_at": "2026-10-22T09:30:00.000Z" } ], "has_more": false }

List refunds

GET/v1/refunds

Parameters

statusstringin query: One of pending_approval, approved, processing, succeeded, failed, rejected, cancelled, manual_required.
limitintegerin query: Default 25.
starting_afterstringin query
payment_intent_idstringin query

Responses

200Newest first
400Invalid request
401Missing, invalid or revoked API key
429More than 100 requests in this minute for this keyRetry-After
500Internal error

Error bodies and every code are listed under Errors; limits under Rate limits and Idempotency.