Skip to main content

Verify Transaction

After a successful charge, you need to verify that the payment was successful with PostaPay before giving value to your customer. For every transaction, you must supply a transaction ID Request Payment : To request payment you need to make a POST call to the following url

Alt test Endpoint: https://sandbox.postapay.app/api/v1/transactions/verify/

Request Parameters

FieldTypeDescriptionExample
MerchantCodeNumberA unique number assigned to an organization/merchant registered with ViewTech, through which payment is received (can be Paybill or Till number)2**8
TransactionCodeAlpha-NumericA unique identifier of the transaction sent with the message to the customer."CDKQYQHMD"
sample request
Headers
Key: Authorization
Value: Bearer cFJZcjZ6anEwaThM6UmYyMkJmWm9nMHFRR2xWOQ==
Body:
{
"MerchantCode":"6*****2",
"TransactionCode": "CDKQYQHMD"
}

Response Parameters

FieldTypeDescriptionExample
MerchantCodeStringA unique number assigned to an organization/merchant registered with ViewTech, through which payment is received (can be Paybill or Till number)2*****8
statusCodeNumericThis is a numeric status code that indicates the status of the response. 0 means success and any other code means an error occurred or the request failed.Please refer to the response codes table above.0
detailsJSONThis is an object containing the details of the transaction."data": {}
FirstNameStringThis is the First Name of the customer making the payment, as per the PostaPay register.“John”
MiddleNameStringThis is the Middle Name of the customer making the payment, as per the PostaPay register."kalvin"
LastNameStringThis is the Last Name of the customer making the payment, as per the PostaPay register.“Doe”
CustomerMobileNumericThis is the mobile number of the customer who was involved in the payment transaction.“07********8”
OrgAccountBalanceDecimalThe Amount of money available on the wallet for a specific MerchantCode176.00
TransAmountNumericThe amount of money transacted.350.00
TransactionIDAlphaNumericThis is the unique PostaPay transaction ID for every payment request."763df0f8-a815-40f5-b13f-cdb4632793e6"
TransTimeTimeThis is the Timestamp of the transaction."2022-01-22-06-38-45"
sample response
{
"statusCode": 0,
"detail": "Transaction Details",
"data": {
"TransactionType": "C2B",
"TransID": "RKTQDM7W6S",
"TransTime": "20191122063845",
"TransAmount": "10000.00",
"MerchantCode": "2*****0",
"BillRefNumber": "2547********",
"InvoiceNumber": "",
"OrgAccountBalance": "49197.00",
"CustomerMobile": "2547********",
"FirstName": "John",
"MiddleName": "",
"LastName": "Doe"
}
}