Payment-method icon

FPX Online banking Malaysia Drop-in integration

Add FPX Online banking Malaysia to an existing Drop-in integration.

On this page, you can find additional configuration for adding Online banking Malaysia to your Drop-in integration.

Before you begin

This page assumes you have already:

API reference

You don't 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:

Drop-in 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 example shows how to configure Drop-in to remove the bank logos, and preselect a Online banking Malaysia issuer. In this example, HSBC Bank is selected:

const onlineBankingMalaysiaConfiguration = {
  showImage: false, // Optional. Set to **false** to remove the bank logos from the Online banking Malaysia form.
  issuer: "fpx_hsbc" // Optional. It is set to HSBC Bank. Set this to an **id** of an Online banking Malaysia issuer to preselect it.

Include the onlineBankingMalaysiaConfiguration object when creating a configuration object for Drop-in:

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.