Skip to main content

We've Launched a New Documentation Website (Beta Launch)

The documentation for DuitNow is now available on our newly launched documentation platform. This is an initial beta rollout of our new documentation site, designed to become the long-term home for all documentation moving forward.

You'll find the familiar content you're used to—now hosted on a new platform that will progressively receive updates and enhancements.

We encourage you to start accessing DuitNow materials there to explore the new experience and ensure you're viewing the latest documentation updates. If you have any feedback, please reach out to us.

Visit the New Documentation Website

Enquire Payment Method Status

Check the status of the saved payment methods. Parse in the unique checkoutId and PayNet will return the corresponding consent status and ID.

info

Use this API if to retrieve the consent status if you do not receive the webhook for Update Consent Status.

Process Flow

StepSenderReceiverProcess
1AcquirerAPI GatewayAcquirer initiates an enquiry via checkoutId for the status of the consent.
2API GatewayAcquirerAPI Gateway will locate the consent status and response back to acquirer.


Request

GET /v1/bw/consent/request?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.
transactionStatusStringMax length: 35Required
Transaction Status:

PDNG = Pending
ACTV = Active
CANC = Cancelled
PDAU = Pending authorization
EXPI = Expired
consentIdStringMax length: 35Required
The consent that is authorized for AutoDebit payment.
issuerStringMax length: 100Required
Name of payer’s issuing bank / wallet.
End Data Object
messageStringMax length: 1024Required
Please refer to the list of reason codes.


Sample Response:

{
"data": {
"messageId": "20240119M0000201814OBW00000005",
"transactionStatus": "PNDG",
"consentId": "M00002010012700006",
"issuer": "Affin Bank"
},
"message": "U000"
}