This page explains how to add Online banking Malaysia to your existing Web Components integration.
Requirements
Select the server-side flow that your integration uses:
Import resources for v6
If you are using Web Components v6, import the Component that you need for Online banking Malaysia:
import { AdyenCheckout, MolPayEBankingMY } from '@adyen/adyen-web'API reference
You do not need to send additional fields for Online banking Malaysia. 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="molpay_ebanking_fpx_MY-container"></div>Step 2: Create an instance of the Component
v6.0.0 or later
Create an instance of the Component, passing:
- Your instance of
AdyenCheckout.
const onlineBankingMalaysia = new MolPayEBankingMY(checkout).mount('#molpay_ebanking_fpx_MY-container');v5.x.x or earlier
Use the create method of your AdyenCheckout instance, in this case checkout, to create the Component:
const onlineBankingMalaysiaComponent = checkout.create('molpay_ebanking_fpx_MY').mount('#molpay_ebanking_fpx_MY-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 Online banking Malaysia form. | true |
issuer |
Set to an Online banking Malaysia issuer ID to preselect a specific bank. | No bank is preselected. |
highlightedIssuers |
Set to the Online banking Malaysia 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 examples show how to configure the Component to remove the bank logos, and preselect an Online banking Malaysia issuer. In the following examples, HSBC Bank is selected.
v6.0.0 or later
const configuration = { showImage: false, issuer: 'fpx_hsbc' };
const component = new MolPayEBankingMY(checkout, configuration);v5.x.x or earlier
const configuration = { showImage: false, issuer: 'fpx_hsbc' };
const component = checkout.create('molpay_ebanking_fpx_MY', configuration);Create an instance of the Component that includes your optional configuration.
v6.0.0 or later
Create an instance of the Component, passing:
- Your instance of
AdyenCheckout. - The payment method-specific configuration.
const onlineBankingMalaysia = new MolPayEBankingMY(checkout, onlineBankingMalaysiaConfiguration).mount('#molpay_ebanking_fpx_MY-container');v5.x.x or earlier
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 onlineBankingMalaysiaComponent = checkout.create('molpay_ebanking_fpx_MY', onlineBankingMalaysiaConfiguration).mount('#molpay_ebanking_fpx_MY-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 Online banking Malaysia Component for the respective country/region, make Online banking Malaysia online banking test payments to test the different payment results.
Check the status of the Online banking Malaysia test payments in your Customer Area > Transactions > Payments.
Before you can accept live Online banking Malaysia payments, you need to submit a request for Online banking Malaysia in your live Customer Area.