Customer payment methods

Save, list, and manage customer payment methods for recurring charges

Supported payment methods

The following payment methods are supported and can be presented to your customers during checkout.

Card

Visa, Mastercard, American Express, Diners Club

Apple Pay

Wallet payment on Apple devices

Google Pay

Wallet payment on Android devices

Samsung Pay

Wallet payment on compatible Samsung devices

PayJustNow

Buy now, pay later for South Africa

Cards are the only payment method that can be saved and reused as a customer payment method.

Payment method lifecycle

Payment methods are saved during checkout and can be reused for future charges. This enables one-click checkout and recurring billing without requiring customers to re-enter their card details.

When to save cards

  • Subscriptions - Automatic recurring billing
  • One-click checkout - Faster repeat purchases
  • Marketplaces - Multiple purchases from same buyer
  • Free trials - Charge when trial ends

Key concepts

payment_method_id

Unique identifier for a saved card (pm_xxx)

customer_id

Links payment methods to a customer (cus_xxx)

setup_future_usage

Tells Orchestration to save the card (on_session / off_session)