Enquire Payment Status
Retrieves the status of the payment that has previously been created via checkout. Parse in the unique checkoutId and PayNet will return the corresponding payment status.
info
Acquirer should perform retrieve payment status after 60 mins before updating the final status for the transaction.
Process Flow
Step | Sender | Receiver | Process |
---|---|---|---|
1 | Acquirer | API Gateway | Acquirer initiates an enquiry via checkoutId for the status of the transaction. |
2 | API Gateway | Acquirer | API Gateway will locate the transaction status and response back to acquirer. |
Request
GET /v1/bw/rtp?checkoutId=a7e2ed2a-b088-4495-8cf4-88da08f644f2
Attention
This API has a rate limit, therefore can only be called once every 30 seconds.
checkoutId | String | Max length: 36 | Required | |||
The unique external identifier (uuid v4) provided by the acquirer to PayNet when initiating a payment intent. |
Response
Data Object | ||||||
messageId | String | Max length: 35 | Required | |||
Unique message identification from RPP. This can be used to reconcile with RPP BackOffice or Reports. | ||||||
endToEndId | String | Max length: 35 | Required | |||
Unique message identification from RPP. This can be used to reconcile with RPP BackOffice or Reports. | ||||||
transactionStatus | String | Max length: 35 | Required | |||
Transaction status: RECEIVED – Pending CLEARED – Successful Credit REJECTED – Rejection from Debiting Agent PENDAUTH – Pending authorization from Debiting Agent | ||||||
issuer | String | Max length: 100 | Required | |||
Name of payer’s issuing bank / wallet. | ||||||
paymentMethod | String | Max length: 35 | Required | |||
Payer selected payment method: 01 - DuitNow Online Banking / Wallets | ||||||
End Data Object | ||||||
message | String | Max length: 1024 | Required | |||
Please refer to the list of reason codes. |
Sample Response:
{
"data": {
"messageId": "20240119M0000201864OBW00000004",
"endToEndId": "20240119M0000201861OBW00000004",
"transactionStatus": "RECEIVED",
"issuer": "Affin Bank",
"paymentMethod": "01"
},
"message": "U000"
}