Skip to content
Create account or Sign in
The Stripe Docs logo
/
Create accountSign in
OverviewAccept a paymentUpgrade your integration
Online payments
OverviewFind your use case Use Managed PaymentsRecurring payments
In-person payments
Payment methods
Payment operations
Balances and settlement time ReceiptsRefunds and cancellations
Advanced integrations
Beyond payments

Accept an FPX payment

Learn how to accept FPX, a common payment method in Malaysia.

Caution

Stripe can automatically present the relevant payment methods to your customers by evaluating currency, payment method restrictions, and other parameters.

  • Follow the Accept a payment guide to build a Checkout integration that uses dynamic payment methods.
  • If you don’t want to use dynamic payment methods, follow the steps below to manually configure the payment methods in your Checkout integration.

FPX is a single-use payment method. Customers pay with FPX by redirecting from your website, sending you payment, then returning to your website where you get immediate notification on whether the payment succeeded or failed.

Determine compatibility

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).

Accept a payment

Note

Build an integration to accept a payment with Checkout before using this guide.

This guides you through enabling FPX and shows the differences between accepting payments using dynamic payment methods and manually configuring payment methods.

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.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=myr \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=fpx \
  --data-urlencode success_url="https://example.com/success"

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 customize your success page.

When customizing, 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.

Information Source of information
Transaction Date & Time created from the Charge object.
Amount amount from the Charge object.
Seller Order No. statement_descriptor from the Charge object.
FPX Transaction ID payment_method_details[fpx][transaction_id] from the Charge object.
Buyer Bank Name payment_method_details[fpx][bank] from the Charge object
Transaction Status status from the Charge object

Test your integration

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

Handle refunds and disputes

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

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

See also

Proxying: stripe.com/nz/docs/payments/fpx/accept-a-payment ✕