Payment Methods#
Plexy supports a wide range of payment methods to help you accept payments from customers across different regions. This guide provides an overview of available payment methods and how to enable them.Payment Method Categories#
Cards#
Accept major card networks with built-in fraud protection and 3D Secure authentication.| Card Network | Regions | Features |
|---|
| Visa | Global | 3D Secure, tokenization, recurring |
| Mastercard | Global | 3D Secure, tokenization, recurring |
| American Express | Global | 3D Secure, tokenization |
| UnionPay | China, Global | 3D Secure, tokenization |
Card payments automatically support 3D Secure 2 authentication when required by the issuing bank, improving authorization rates and reducing fraud.
Digital Wallets#
Offer fast, secure checkout with popular digital wallet providers.| Wallet | Regions | Features |
|---|
| Apple Pay | Global | One-tap checkout, biometric auth |
| Google Pay | Global | One-tap checkout, tokenized cards |
Handling Payment Methods in Your Integration#
Sessions Flow#
When using the Sessions flow, Plexy automatically displays available payment methods:Advanced Flow#
When using the Advanced flow, fetch available methods and render your own UI:Payment Method Features#
Tokenization#
Save payment methods for returning customers:Cards - Tokenize for one-click checkout
Wallets - Automatically tokenized by wallet provider
Bank accounts - Save for recurring debits (where supported)
Recurring Payments#
Supported payment methods for subscriptions:Visa, Mastercard (card-on-file)
Partial Payments#
Some methods support partial captures and refunds:| Method | Partial Capture | Partial Refund |
|---|
| Cards | Yes | Yes |
| Wallets | Yes | Yes |
Best Practices#
1.
Offer multiple methods - Different customers prefer different payment methods
2.
Show relevant methods - Use geolocation to prioritize local payment methods
3.
Display logos - Payment method logos increase trust and recognition
4.
Handle failures gracefully - Offer alternative methods if one fails
5.
Verify thoroughly - Run end-to-end checks before enabling each payment method for customers
Payment method availability may vary by region and account configuration. Contact Plexy support to enable additional payment methods for your account.
Build Your Integration - Choose an integration approach
3D Secure - Learn about card authentication
Tokenization - Save payment methods for reuse
Checkout Settings#
Configure your checkout with the right parameters to create a seamless payment experience. This guide covers all the configurable options for Plexy checkout sessions and payments.Amount and Currency#
Every payment request requires an amount object specifying the value and currency.Amounts are specified in the smallest currency unit (e.g., cents for USD, tiyn for KZT).| Currency | Minor Units | Example |
|---|
| KZT (Kazakhstani Tenge) | 100 | 1000 = ₸10.00 |
| USD (US Dollar) | 100 | 1000 = $10.00 |
| EUR (Euro) | 100 | 1000 = €10.00 |
KZT amounts are submitted in tiyn (1/100 of a tenge), so value: 10000 equals
exactly ₸100.00.
Supported Currencies#
Common supported currencies:| Code | Currency | Symbol |
|---|
KZT | Kazakhstani Tenge | ₸ |
USD | US Dollar | $ |
EUR | Euro | € |
Country Codes#
The country code affects which payment methods are available and how transactions are processed.Providing shopper details improves payment success rates and fraud detection.shopperLocale is the checkout interface language and regional formatting, for example ru-KZ, en-US, or kk-KZ. Do not use it as a currency field. Currency belongs only in amount.currency, for example KZT.
Basic Shopper Data#
Return URLs#
Configure where customers are redirected after payment.Return URL Parameters#
Plexy appends these query parameters to your return URL:| Parameter | Description |
|---|
resultCode | Payment result (Authorised, Refused, etc.) |
sessionId | The session ID |
reference | Your merchant reference |
pspReference | Plexy's payment reference |
https://your-site.com/checkout/complete?resultCode=Authorised&sessionId=ses_abc123&reference=order_12345&pspReference=8835511210681324
Payment Method Configuration#
Control which payment methods are displayed.Available Payment Method Types#
| Type | Description |
|---|
scheme | Credit/Debit cards |
applepay | Apple Pay |
googlepay | Google Pay |
3D Secure Configuration#
Control 3D Secure behavior.
Currency Codes#
Supported currencies and how to format amounts.Amounts are specified in the smallest currency unit (e.g., cents):| Currency | Amount | Meaning |
|---|
| KZT | 5000 | 50.00 ₸ |
| USD | 5000 | $50.00 |
| EUR | 5000 | 50.00 |
| GBP | 5000 | 50.00 |
| JPY | 5000 | 5,000 |
Converting amounts#
Minimum amounts#
Each currency has a minimum charge amount:| Currency | Minimum |
|---|
| USD | $0.50 |
| EUR | 0.50 |
| GBP | 0.30 |
| JPY | 50 |
See also#
