Skip to main content

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

StepSenderReceiverProcess
1AcquirerAPI GatewayAcquirer initiates an enquiry via checkoutId for the status of the transaction.
2API GatewayAcquirerAPI 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.

checkoutIdStringMax length: 36Required
The unique external identifier (uuid v4) provided by the acquirer to PayNet when initiating a payment intent.


Response

Data Object
messageIdStringMax length: 35Required
Unique message identification from RPP. This can be used to reconcile with RPP BackOffice or Reports.
endToEndIdStringMax length: 35Required
Unique message identification from RPP. This can be used to reconcile with RPP BackOffice or Reports.
transactionStatusStringMax length: 35Required
Transaction status:

RECEIVED – Pending
CLEARED – Successful Credit
REJECTED – Rejection from Debiting Agent
PENDAUTH – Pending authorization from Debiting Agent
issuerStringMax length: 100Required
Name of payer’s issuing bank / wallet.
paymentMethodStringMax length: 35Required
Payer selected payment method:

01 - DuitNow Online Banking / Wallets
End Data Object
messageStringMax length: 1024Required
Please refer to the list of reason codes.


Sample Response:

{
"data": {
"messageId": "20240119M0000201864OBW00000004",
"endToEndId": "20240119HBMBMYKL070ORB00000007",
"transactionStatus": "RECEIVED",
"issuer": "Affin Bank",
"paymentMethod": "01"
},
"message": "U000"
}