On this page, you can find additional configuration for adding MOLPay to your Components integration.
Before you begin
This page assumes you have already:
API reference
You don't need to send additional fields for MOLPay. To see optional fields that you can send for all payment methods, choose the endpoint you integrated:
- /sessions: This is the default with Components v5.0.0 or later.
- /payments: If you implemented an additional use case.
Component configuration
Step 1: Create a DOM element
Create a DOM element on your checkout page, placing it where you want the payment method form to be rendered:
<div id="mol_pay-container"></div>
Step 2: Create an instance of the Component
Use the create
method of your AdyenCheckout
instance, in this case checkout
, to create the Component:
const molPayComponent = checkout.create('mol_pay').mount('#mol_pay-container');
Optional configuration
You can add the following optional configuration:
Parameter name | Description | Default |
---|---|---|
showImage |
Set to false to remove the bank logos from the MOLPay form. | true |
issuer |
Set to a MOLPay issuer ID to preselect a specific bank. | No bank is preselected. |
highlightedIssuers |
Set to the MOLPay issuer IDs for banks you want to show on top of the dropdown menu. Added in v5.1.0 | All issuers are shown in the dropdown. |
placeholder |
The string you want to show as the dropdown menu text. Custom translation configuration overrides this value. | Select your bank |
If you want to add an optional configuration, include this in a configuration object. The following example shows how to configure the Component to remove the bank logos, and preselect a MOLPay issuer. In this example, HSBC Bank is selected:
const molPayConfiguration = {
showImage: false, // Optional. Set to **false** to remove the bank logos from the MOLPay form.
issuer: "fpx_hsbc" // Optional. Set this to an **id** of an MOLPay issuer to preselect it. It is set to HSBC Bank.
};
Use the create
method of your AdyenCheckout
instance, in this case checkout
, to create an instance of the Component. Add the configuration object if you created one.
const molPayComponent = checkout.create('mol_pay', molPayConfiguration).mount('#mol_pay-container');
List of issuer IDs
Bank name | Issuer ID |
---|---|
Affin Bank | fpx_abb |
Agro Bank | fpx_agrobank |
Alliance Bank | fpx_abmb |
Am Bank | fpx_amb |
Bank Islam | fpx_bimb |
Bank Muamalat | fpx_bmmb |
Bank Rakyat | fpx_bkrm |
Bank Simpanan Nasional | fpx_bsn |
CIMB Bank | fpx_cimbclicks |
Hong Leong Bank | fpx_hlb |
HSBC Bank | fpx_hsbc |
Kuwait Finance House | fpx_kfh |
Maybank | fpx_mb2u |
OCBC Bank | fpx_ocbc |
Public Bank | fpx_pbb |
RHB Bank | fpx_rhb |
Standard Chartered Bank | fpx_scb |
UOB Bank | fpx_uob |
Test and go live
Using any issuer ID that is available for the MOLPay eBanking Component for the respective country, make MOLPay online banking test payments to test the different payment results.
Check the status of the MOLPay test payments in your Customer Area > Transactions > Payments.
Before you can accept live MOLPay payments, you need to submit a request for MOLPay in your live Customer Area.