Transaction Query

POST

https://api.paybeta.ng/v2/transaction/query

Query Transaction Status

Using a POST method, transaction status can be queried with the endpoint below passing the reference you generated for the payment:

Field	Mandatory/Optional	Description
code	O	This is usually returned as response and can also confirmes the final status of a transaction. 00 = successful 01 = pending 02 = failed 99 = Not found or invalid reference
status	O	This is returned as response and tells the final status of the transaction.
reference	M	This is the reference with which you sent when purchasing a transaction after the transaction has been processed.

Request

Authorization

Add parameter in header

P-API-KEY

Example:

P-API-KEY: ********************

Header Params

Body Params application/json

Examples

Responses

🟢200Successful

application/json

Body

🟠404Invalid Reference

🟢200Failed

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.paybeta.ng/v2/transaction/query' \
--header 'Accept: application/json' \
--header 'Accept;' \
--header 'P-API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference": "1746988617"
}'

Response Example

200 - Successful

{
    "status": "successful",
    "message": "Your glo airtime payment is successful",
    "code": "00",
    "data": {
        "paymentStatus": "Delivered",
        "reference": "1746988617",
        "amount": 100,
        "amountPaid": 96,
        "product": "GLO AIRTIME",
        "customerId": "09052216560",
        "token": "0",
        "unit": "0",
        "transactionId": "API-174698861781391390",
        "transactionDate": "2025-05-11T18:37:01.000000Z"
    }
}

Modified at 2025-09-19 21:34:05

Balance

Transaction Query

Query Transaction Status#

Request

Responses

Query Transaction Status