Refund API

This documentation site has been deprecated as of September 8, 2025, and will no longer receive updates. Please refer to the new documentation site at https://docs.squadco.com.

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

POST https://sandbox-api-d.squadco.com/transaction/refund

Request Body

Name	Type	Description
gateway_transaction_ref*	String	Unique reference that uniquely identifies the medium of payment and can be obtained from the webhook notification sent to you.
transaction_ref*	String	unique reference that identifies a transaction. Can be obtained from the dashboard or the webhook notification sent to you
refund_type*	String	The value of this parameter is either "Full" or "Partial"
reason_for_refund*	String	Reason for initiating the refund
refund_amount	String	Refund amount is in kobo or cent. This is only required for "Partial" refunds

200: OK Successful

{
    "status": 200,
    "success": true,
    "message": "Success",
    "data": {
        "gateway_refund_status": "pending",
        "refund_status": 2,
        "refund_reference": "REFUND-SQOKOY1708696818297_1_1"
    }
}

401: Unauthorized No API Key

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",
    "refund_amount":"20000"
}

GO LIVE - Production

To Use this API on production:

1. Kindly change the base URL of the endpoint from sandbox-api-d.squadco.com to api-d.squadco.com

2. Get production keys from your production environment on dashboard.squadco.com and replace as authorization keys.