Accept an FPX payment
Learn how to accept FPX, a common payment method in Malaysia.
Checkout
Elements
Mobile
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 aren’t supported).
Accept a payment
Note
Build an integration to accept a payment with Checkout before using this guide.
Enable FPX as a payment method
When creating a new Checkout Session, you need to:
- Enable FPX in your Dashboard. Stripe automatically displays FPX to eligible customers using dynamic payment methods . If you currently specify payment _ method _ types , see the migration guide .
- Make sure all your line _ items use the myr currency.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
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.