HomeGuidesAPI Reference
API Reference

Overview

Saved Cards (Tokenization)

The Saved Cards feature allows you to securely store customer card details as a token and reuse them for future payments.

This improves checkout speed and eliminates the need to re-enter card details for returning customers.


Saved Cards Flow

Tokenized Sale

Perform a SALE request and save the card using tokenization.

Retrieve Saved Cards

Fetch all saved cards linked to a customer.

Token Payment

Charge the customer using a previously saved card token.


How It Works

• Customer completes a payment using card details
• System generates a secure card_token
• You retrieve saved cards when needed
• Future payments are processed using the token


Key Concepts

  • card_token → Secure reference to a saved card
  • Tokenization → Replacing card data with a secure token
  • Masked Card → Only part of the card is visible for security

⚠️

Important Note

• Cards are saved only if save_token = "Y"

• Token payments require payment_type = "TOKEN"

• Always use the token returned from the saved cards API


🔐

Security


Tokens can be safely stored and reused. Sensitive card data is never exposed after the initial transaction.


Best Practice


Store the card_token along with masked card details (last 4 digits and brand) to allow customers to easily select a saved card.