v1

latestOpenAPI 3.1.02026-07-24590534.0 KB

Submit refund bank details

Submits the bank account that should receive the refund.

post/refunds/{merchant_reference}/details

Path parameters

merchant_referencestring required

Request body

account_numberstring

The bank account number that will receive the refund. It cannot be empty.

bank_codestring

The code that identifies the bank. It cannot be empty.

account_namestring

The account holder’s name returned by the account verification endpoint.

Response

200

statusstring

messagestring

Example response

{
  "status": "ok",
  "message": "Refund details submitted successfully",
  "data": {
    "public_id": "refund-public-id",
    "refund_reference": "refund-reference",
    "status": "refund_details_received",
    "amount": "1000.0",
    "currency": "NGN",
    "merchant_reference": "merchant-transaction-reference",
    "created_at": "2026-07-20T10:00:00.000Z",
    "updated_at": "2026-07-20T10:05:00.000Z"
  }
}