Skip to main content

Verify Transaction

This is an endpoint that allows you to query the status of a particular transaction using the unique transaction reference attached to the transaction.

info

Environment base URL:

Test: https://sandbox-api-d.squadco.com

Production: https://api-d.squadco.com

Authorization keys are to be passed via Headers as a Bearer token.

Example: Authorization: Bearer sandbox_sk_94f2b798466408ef4d19e848ee1a4d1a3e93f104046f.

Response Data Object​

The data object returned in the response is null when the status code is 400 and populated when the status code is 200.

The data object contains a parameter known as the transaction_status which differentiates the transaction type.

Transaction status can either be Success, Failed, Abandoned or Pending

GET
https://sandbox-api-d.squadco.com/transaction/verify/{{transaction_ref}}

This verifies a transaction

To verify the validity of a transaction, kindly query the endpoint above by replacing {{transaction_ref}} with the unique transaction_ref of the transaction you want to verify

Parameters

Query

transaction_ref*

String

Unique transaction reference that identifies each transaction

Responses

200:OK
Valid Transaction Reference
{
            "status": 200,
            "success": true,
            "message": "Success",
            "data": {
                "transaction_amount": 5000,
                "transaction_ref": "SQCHIZ3634573076082",
                "email": "ayo@gmail.com",
                "transaction_status": "Success",
                "transaction_currency_id": "NGN",
                "created_at": "0001-01-01T00:00:00",
                "transaction_type": "VirtualAccount",
                "merchant_name": "CHIZOBA ANTHONY",
                "merchant_business_name": null,
                "gateway_transaction_ref": "SQCHIZ3634573076082",
                "recurring": null,
                "merchant_email": "okoyeanthonychizoba@gmail.com",
                "plan_code": null
            }
}
400:Bad Request
Invalid Transaction Reference
{
            "status": 400,
            "success": false,
            "message": "Invalid transaction reference",
            "data": {}
}
401:Unauthorized
Unauthorized Request
{
            "success": false,
            "message": "",
            "data": {}
}
403:Forbidden
Invalid API Key
{
            "success": false,
            "message": "API key is invalid. Key must start with sandbox_sk_",
            "data": {}
}

Verify POS Transaction

To verify the validity of a POS transaction, kindly query the endpoint above, passing the transaction_reference as the value in the path variable

GET
https://api-d.squadco.com/softpos/transaction/verify/:transaction_reference

This verifies a POS transaction

To verify the validity of a POS transaction, kindly query the endpoint above, passing the transaction_reference as the value in the path variable

Parameters

Responses