PAYVANTAGE API Documentation
  • Home
  • Vending
    • Data
    • Airtime
    • Check Transactions/Requery
    • Auto TopUp
    • OptOut Auto TopUp
    • Transaction Status Notification
  • SoftPOS
  • Education
    • JAMB
      • WAEC
  • Virtual Account
Powered by GitBook
On this page
  • Sample request to check transaction status
  • Endpoint to check transaction status
  • Sample request to check network provider
  • Endpoint to check network provider
  1. Vending

Check Transactions/Requery

An endpoint to requery pending transaction. This endpoint is called whenever single_airtime_direct_vending returns pending response

Sample request to check transaction status

For Airtime

{"service_code":"100", "transaction_id" : "80kjd-61269142-test-n21"}

For Data

{"service_code":"200", "transaction_id" : "80kjd-61269142-test-n21"}

Endpoint to check transaction status

POST {{baseUrl}}/service/api/check_transaction_status

Headers

Name
Type
Description

x-api-key*

String

The API key is a unique key that must be passed to the header before any request and can be found in the dashboard.

client-id*

String

This is a unique id for customers which can also be found in the dashboard.

{
    "status_code": "200",
    "message": "Successful",
    "result": {
        "status_code": "200",
        "message": "Successful",
        "phonenumber": "0816965167",
        "amount": "5",
        "network": "MTN",
        "transaction_id": "80kjd-61269142-test-n21",
        "transaction_date": "2022-09-09 12:33:53.13"
    }
}
{
    "status_code": "3",
    "message": "is not found",
    "result": null
}
{
    "status_code": "500",
    "transaction_id": "166272313399778110",
    "reference": "80kjd-612269142-test-n21",
    "phonenumber": "08169653167",
    "network": "MTN",
    "message": "unsuccessful"
}
{
   "status_code": "501",
   "message": "Processing"
}

Sample request to check network provider

{
    "phonenumber":"08167343212"
}

Endpoint to check network provider

POST {{baseUrl}}/service/api/check_network_provider

Headers

Name
Type
Description

x-api-key*

String

The API key is a unique key that must be passed to the header before any request and can be found in the dashboard.

client-id*

String

This is a unique id for customers which can also be found in the dashboard.

Request Body

Name
Type
Description

phonenumber*

String

{
    "status_code": "0",
    "network": "MTN",
    "message": "Record found"
}
{
    "status_code": "1",
    "network": null,
    "message": "Record not found"
}
PreviousAirtimeNextAuto TopUp

Last updated 11 months ago