Transaction Verification¶
In a situation where the call back url is not suitable, the developer might require a way to query transactions to know the status of transactions.
We have an API endpoint for checking transaction status with url as stated below:
https://api.paylot.co/transactions/verify/{reference}
reference: This is the reference used while creating a transaction or the reference returned in the callback.
To access this endpoint, the business secret key is required and this secret key can be obtained at the business profile page.
This key should never be exposed to the public and is of the format:
pyt_sk-123455***
To send a request, use bearer authentication with your secret key as token i.e. add this to your request header.
Authorization: Bearer pyt_sk-123455***
The API returns an object with the parameters described below.
Parameter | Description |
---|---|
reference | The transaction reference. Pay attention to this if you didn’t create a reference manually. (string) |
sent | Specifies if payment was made successfully (boolean) |
confirmed | Specifies if the payment has been confirmed on the blockchain (boolean) |
amount | Specifies the intended amount in the currency selected during payment (number) |
amountSent | Specifies the actual amount that was sent to the blockchain (number) |