Tokenize
Overview
The tokenize method stores a payment method securely at the payment processor. It replaces sensitive card data with a secure token, enabling one-click payments without PCI compliance exposure.
Business Use Case: A customer wants to save their card for faster checkout next time. Tokenize the card details to create a secure token for future use.
Purpose
One-click checkout
No re-entry of card details
Recurring billing
Stored methods for subscriptions
PCI compliance
No raw card storage in your system
Security
Tokens are useless if compromised
Request Fields
paymentMethod
PaymentMethod
Yes
Card or wallet details to tokenize
customerId
string
No
Associate with existing customer
metadata
object
No
Additional data (max 20 keys)
Response Fields
paymentMethodId
string
Token ID for future use (e.g., pm_xxx)
paymentMethodType
string
card, wallet, etc.
status
string
ACTIVE
fingerprint
string
Unique identifier for this card
statusCode
number
HTTP status code
Example
SDK Setup
Request
Response
Using Tokenized Payment Methods
Next Steps
Payment Service - Use tokenized payment methods
Recurring Payment Service - Set up subscriptions with stored cards
Last updated
Was this helpful?

