Your merchant account will be configured with different payment methods when you use Checkout. The available payment methods are below:
- One-time payment using Credit/Debit/Prepaid Card Payments
- Pay with Maya (Via QR or Login)
- Plugins: Shopify, Magento 2, WooCommerce
- Payment Links
- Invoice Payments
- Coming soon Alipay
- Coming soon Alternative payment methods (Bank Pulls)
- Coming soon GrabPay
Contact your account manager in order to activate the payment method of your choice.
When the customer is done with adding items to their cart or basket, your application must build the required JSON body.
The JSON inputs are below:
An object that contains the
The reference number that will be generated from the merchant's side. It is recommended to use unique id generator such as uuid
An object that contains where Maya will redirect to after a successful payment. The fields supported are
Contains the buyer details. This is optional by default and will use the Basic Buyer format. However this is required for merchants who are Kount-enabled.
Review the Kount Buyer fields for the required fields if you are Kount enabled
An array of the objects. Each object contains the information that a customer will pay for.
Optional. Used to provide additional data to the transaction such a payment faciliator information. Contact your account manager to know more about and if you are required to fill-in the object
Optional. Used for Manual Capture. The accepted values are:
Once you have the payment body set up, your application will then pass it as a JSON body to Create Checkout endpoint. Once successful, it will respond with a
redirectUrl that your application will redirect to.
Using Mastercard/Visa cards on Checkout
Authentication for Card payments is done via 3D Secure. Webpages that your customer is redirected to belong to the card issuer. Authentication challenges may vary.
Using Maya e-wallet on Checkout
Authentication for Pay With Maya is done via the Maya login page and One-time PIN challenge.
redirectUrl that was returned by Create Checkout is a Maya Business hosted page. Your application will need to execute a redirection in order for the customer to proceed with the payment via credit card or e-wallet
Once the customer has successfully completed the payment, the Maya page will automatically redirect back (after 10s) to your application via the
redirectUrl that was passed during the payment initiation above.
The redirection after a successful payment does not guarantee that the payment information will be updated. Your application should manage payment information updates by implementing webhooks.
Updated about 1 month ago