API Reference

Get the Status of a transaction API

get
https://example.com/api/v1.0/debit/status

This API is used to Get the status of a transaction.

In case of any HTTP response code other than 200 received in the response, please 'DO NOT FAIL' the transaction.

Instead, hit the 'Transaction Status' API again or reach out to the Ayoconnect team via Whatsapp or send an email to the Ayoconnect's Operations team.

Service Code: 36

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required
length between 6 and 6

Unique identifier of merchant.

string
required

Value of X-External-ID header of the original transaction.

Headers
string
enum
required
length between 16 and 16

Represents the media type that the client is able to accept from the server (e.g. application/json).

Allowed:
string
required

Represents the access_token of a request; string starts with the keyword "Bearer " followed by the access_token.

string
required
length between 24 and 27

Client's current local time in yyyy-MM-ddTHH:mm:ss.SSSTZD format.

string
length between 32 and 32

Client's client_id (PJP Name). It is provided when the registration process is completed.

string
required

Represents signature of a request. Symmetric signature: HMAC_SHA512(clientSecret, stringToSign)

stringToSign = HTTPMethod +":"+ URLPath +":"+ AccessToken +":"+ Lowercase(HexEncode(SHA-256(minify(RequestBody))))+":" + X-TIMESTAMP

string
required
length between 6 and 6

This field is a 6 char merchant identifier that is unique per each merchant. The exact value is disclosed to each merchant separately.

string
required
length between 32 and 32

Alphanumeric String. Reference number that should be unique in the same flow.

string
required
length between 5 and 5

Numeric String. PJP's channel id. Device identification on which the API services is currently being accessed by the end user (customer). Must be the same in one flow.

Response

Updated 5 months ago

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 5 months ago