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.

Digital Wallets

Offer fast, secure checkout with popular digital wallet providers.

Handling Payment Methods in Your Integration

Sessions Flow

When using the Sessions flow, Plexy automatically displays available payment methods:

const session = await plexy.sessions.create({
  amount: {
    value: 10000,
    currency: 'KZT'
  },
  countryCode: 'KZ',
  returnUrl: 'https://your-site.com/checkout/complete'
});

Advanced Flow

When using the Advanced flow, fetch available methods and render your own UI:

// 1. Get available payment methods
const methods = await plexy.paymentMethods.list({
  amount: { value: 10000, currency: 'KZT' },
  countryCode: 'KZ'
});

// 2. Display methods to customer and collect their choice

// 3. Submit payment with selected method
const payment = await plexy.payments.create({
  amount: { value: 10000, currency: 'KZT' },
  paymentMethod: {
    type: 'scheme'
  },
  returnUrl: 'https://your-site.com/checkout/complete'
});

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:

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. Test thoroughly - Use test mode to verify each payment method works correctly

Related Resources

• Build Your Integration - Choose an integration approach
• 3D Secure - Learn about card authentication
• Tokenization - Save payment methods for reuse