Transaction Status Query

POST /v1/api/betting/{providerSlug}/verify-transaction

This endpoint is used to enquire about the status of the transaction

Parameters

Field	Mandatory	Parameter Type	Data Type	Description
api-key	Yes	Header	String	The client’s API key
secret	Yes	Header	String	The client's secret key for the environment to which the request is being made
providerSlug	Yes	Path	String	The slug of the betting provider
reference	Yes	Query	String	The reference of the transaction

Sample Request

curl --location '{BASE_URL}/v1/api/betting/{providerSlug}/verify-transaction?reference={reference}' \ --header 'secret: {SECRET_KEY}' \ --header 'api-key: {API_KEY}'

Sample Response (200 - OK, Successful Transaction )

{
    "status": "SUCCESS",
    "message": "Successful",
    "statusCode": "00",
    "data": {
        "amount": "10000",
        "transactionStatus": "Success",
        "reference": "b5169c6e4d09a0de0568d3500b30c5cc",
    }
}

Sample Response (200 - OK, Failed Transaction)

{
    "status": "SUCCESS",
    "message": "Successful",
    "statusCode": "00",
    "data": {
        "amount": "20000",
        "transactionStatus": "Failed",
        "reference": "90cd6345e7c05ffca67216dd656202ae"
    }
}

Note

Please note that the outer status field only signifies whether TSQ request is successful or not (request status). The transactionStatus field in the data object contains the final status of a transaction (transaction status).

Sample Response (404 - NOT FOUND)

{
    "status": "FAILED",
    "message": "Invalid reference provided",
    "statusCode": "25"
}