Refunds

Process payment refunds.

Refund Transaction

Initiate a refund for a completed transaction.

Endpoint: POST /v1/pay/transactions/{id}/refund

Authentication: Required

Request Body:

Field	Type	Required	Description
`amount`	string	No	Refund amount (optional, defaults to full refund)
`reason`	string	No	Reason for refund

Example:

HTTP

TypeScript

Python

Success Response (201):

{
  "data": {
    "id": "ref_abc123",
    "transaction_id": "txn_abc123",
    "amount": "50.00",
    "currency": "GMD",
    "reason": "Customer requested partial refund",
    "status": "pending",
    "created_at": "2024-01-15T11:00:00Z"
  }
}

Refund Statuses:

pending - Refund initiated, processing

completed - Refund completed successfully

failed - Refund failed

INFO

Partial Refunds: You can refund any amount up to the original transaction amount. Multiple partial refunds are supported until the full amount is refunded.

List Refunds

Get a paginated list of refunds.

Endpoint: GET /v1/pay/refunds

Authentication: Required

Query Parameters:

Parameter	Type	Required	Description
`offset`	integer	No	Number of items to skip
`limit`	integer	No	Maximum number of items to return
`status`	string	No	Filter by status

Get Refund

Get details of a specific refund.

Endpoint: GET /v1/pay/refunds/{id}

Authentication: Required

Example:

HTTP

TypeScript

Python

Refunds

Refund Transaction#

List Refunds#

Get Refund#

Refund Transaction

List Refunds

Get Refund