DQR endpoint API details needed for hosting QR code

HI Team

Could you please help with DQR endpoint API details needed for hosting QR code at merchant’s end?

To host the QR code on your merchant’s webpage, use the Create Dynamic QR endpoint. This API returns a qrCodeBody in the response, which you can embed directly into your self-hosted page. Follow these steps:

  1. Make a POST request to https://pg-sandbox.paymaya.com/payments/v1/qr/payments (Sandbox) or the production endpoint.
  2. Include your public API key in the Authorization header as a base64-encoded string in Basic Auth format.
  3. Provide the required fields in the request body: totalAmount, redirectUrl (success, failure, cancel URLs), and requestReferenceNumber.
  4. Upon success, extract the qrCodeBody from the response and render it as a QR code on your webpage.

The generated QRPh code is valid for 1 hour and is one-time use. For real-time transaction updates, implement webhooks as described in the documentation.

For Sandbox concerns and other technical implementation inquiries, please get in touch with us via:

  • Sandbox Health Page: Check real-time service status updates.
  • Maya Developer Hub Service Desk: File
    a ticket in Sandbox.

To Know More:

We value your input and would love to hear your insights. Please submit you feedback here.

  1. Can this API be used by the merchant for Maya wallets ?
  2. Is this different than QRPH?
  3. Is this applicable to both one-time payments as well as wallet linking flow? or just one-time payments?
  4. If no, Do you have a similar API for hosting QR code for wallet linking?
  5. Lastly, do you have deep link support ?

Hi Team,

Could you please help us with an update on this?

  1. Can this API be used by the merchant for Maya wallets?
    1.1. Yes, the Pay with Maya API keys can be used for generating a Maya QRPh
  2. Is this different than QRPH?
    2.1. It is the same with QRPh. The generated QR already follows the QRPh standards.
  3. Is this applicable to both one-time payments as well as wallet linking flow? or just one-time payments?
    3.1. It is only for one-time payments.
  4. If no, do you have a similar API for hosting QR code for wallet linking?
    4.1. None, wallet linking requires redirection to the Maya-hosted website for login and authentication.
  5. Lastly, do you have deep link support?
    6.1. Pay with Maya’s deeplink feature to the Maya App is temporarily disabled . Customers are now redirected to the web-based payment page of Maya to complete their payment transactions.

References:

Hi @frances.kagahastian

Our understanding is Maya QRPH is used only for Amazon QRPH. The merchant intends to host the QR code at their end so can we use this Dynamic QRPH for normal Pay with Maya as well?

Is there a possibility that user may get confused whether its for QRPH or Pay with Maya QR code?

Because if the QRPH user scans for Pay with QR code, will the transaction get reflected in under QRPH payment method or Pay with Maya payment method?

Does the MDR differs if we use this create Dynamic QR code for Pay with Maya QR code generation? it will remain same as what it is for Stripe?

cc: @renzoatos

We understand that Create Dynamic QR can be used for merchant-hosted QR presentation.
We want to confirm whether this QR is:

  1. a Maya-wallet-only QR, or

  2. a QRPh QR that can be paid by Maya Wallet and other QRPh-participating apps.

Based on your documentation, it appears to be QRPh rather than wallet-only. Please confirm.

Hi @frances.kagahastian

Could you please help respond to this?^

I think the Create Dynamic QR endpoint already generates a QRPh QR, so any bank supporting QRPh can scan and pay.

Thanks, @Cerie ! so this means if a Maya-wallet-only QR user scans through QRPH QR - will it be settled under QRPH payment method or PayMaya?

cc: @renzoatos

I found this document for QRPh: QRPH Payment . You can check the fundSource.type.

It says here that if it’s a non-Maya wallet value will be qrph, then maya-wallet if a Maya account was used.

note: on the Webhook data

Hi @jwadkar, yes, it can be scanned by any bank or e-wallet supporting QRPh. You can check the Webhook guide for QRPh. It was shared by @Cerie in this thread.

Thanks @Cerie!

1 Like

Hi @frances.kagahastian

Regarding the above point, any reason why the deeplink is disabled? If the merchant’s requirement is to have a deep link then can Maya enable it for both one-time payments and wallet link with Maya flow?

cc: @renzoatos @danzel.orig