MOLPay Drop-in integration

Add MOLPay to an existing Drop-in integration.

This page explains how to add MOLPay to your existing Web Drop-in integration.

Requirements

Requirement	Description
Integration type	Make sure that you have an existing Web Drop-in integration.
Setup steps	Before you begin, add MOLPay in your test Customer Area.

API reference

You do not 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 Drop-in v5.0.0 or later.
/payments: If you implemented an additional use case.

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 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 Drop-in 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.
};

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

Pass the Drop-in configuration object when creating your instance of AdyenCheckout:

const checkout = await AdyenCheckout(configuration);

List of issuer IDs

Test and go live

Using any issuer ID that is available for the MOLPay eBanking Component for the respective country/region, 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.