Accept an FPX payment

A Checkout Session must satisfy all of the following conditions to support FPX payments:

• Prices for all line items must be in the same currency. If you have line items in different currencies, create separate Checkout Sessions for each currency.
• You can only use one-time line items (recurring subscription plans are not supported).

Use this guide to learn how to enable FPX – it shows the differences between accepting a card payment and using FPX.

Enable FPX as a payment method

When creating a new Checkout Session, you need to:

1. Add fpx to the list of payment_method_types
2. Make sure all your line_items use the myr currency

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'fpx'],
  line_items: [{
    price_data: {
      currency: 'usd',
      # To accept `fpx`, all line items must have currency: myr
      currency: 'myr',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

Fulfill your orders

After accepting a payment, learn how to fulfill orders.

Confirmation page

FPX requires showing your customer their transaction information after they’ve completed their payment. Follow the custom success page guide to learn how to customise your success page.

When customising, you’ll need to retrieve the Charge object directly from the PaymentIntent object using the PaymentIntent ID from your Checkout Session and display the following information on your success_url page.

When testing your Checkout integration, select FPX as the payment method and click the Pay button.

The refund period for FPX is up to 60 days after the original payment.

There is no dispute process—customers authenticate with their bank.