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.