Payment-method icon

FPX Online Banking Malaysia for API only

Add FPX Online Banking Malaysia to your API-only integration.

You can add FPX Online Banking Malaysia to your existing integration. The following instructions show only what you must add to your integration specifically for FPX Online Banking Malaysia.

If an instruction on this page corresponds with a step in the main integration guide, it includes a link to corresponding step of the main integration guide.

Requirements

Requirement Description
Integration type Make sure that you have an existing API-only integration.
Redirect handling Make sure that your existing integration is set up to handle the redirect.
action.type: redirect.
Setup steps Before you begin, add FPX Online Banking Malaysia in your Customer Area.

How it works

  1. The shopper selects FPX Online Banking Malaysia as the payment method.
  2. The shopper enters their details in the payment form that you build.
  3. When you make the payment request, you include additional information about the items that the shopper intends to purchase.
  4. Your existing integration setup will handle the redirect.

Build your payment form

To show FPX Online banking in your payment form, you need to:

  1. Show a list of available banks to your shopper.
  2. After the shopper selects a bank, pass the corresponding Issuer value to your server. You'll need this to make a payment. All issuers in this list must be included on your checkout to be compliant with PayNet local regulations.

    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

The list of issuing banks are also included in the /paymentMethods response object type: molpay_ebanking_fpx_MY

Get FPX Online Banking Malaysia as an available payment method

When you make the /paymentMethods to get available payment methods, specify the following so that FPX Online Banking Malaysia is included in the response.

Parameter Values
countryCode MY
amount.currency MYR

Add additional parameters to your /payments request

You do not need to add any additional parameters when you make a payment.

The response includes the action.type: redirect.

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.

See also