Refund API

This API is used to initiate refund process on a successful transaction.
Authorization Any request made without the authorization key (secret key) will fail with a 401 (Unauthorized) response code.
The authorization key is sent via the request header as Bearer Token Authorization
Example: Authorization: Bearer sandbox_sk_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f
This endpoint refunds an already completed transactions

Sample Request

Full Refund

"gateway_transaction_ref": "wvszqsdrujscpuaofnea529117332_1_1",
"refund_type": "Full",
"reason_for_refund": "Any reason",
"transaction_ref": "vszqsdrujscpua"

Partial Refund

"gateway_transaction_ref": "SQOKOY3167299494777_1_1",
"refund_type": "Partial",
"reason_for_refund": "Testing Testing",
"transaction_ref": "SQOKOY3167299494777",

GO LIVE - Production

To Use this API on production:
  1. 1.
    Kindly change the base URL of the endpoint from to
  2. 2.
    Get production keys from your production environment on and replace as authorization keys.