Updating Expiring Cards (Critical for Recurring Billing)
The Problem:
Credit cards expire. When a stored payment method expires:
- Card number is still valid (hasn’t changed)
- Token is still valid
- But expiration date is in the past
- Transactions will decline
The Solution:
You can update the expiration date WITHOUT needing the full 16-digit card number again.
Update Process:
- Navigate to Customers tab
- Find the customer (search by name or number)
- Click to open customer profile
- Go to Wallet tab
- Find the expired or expiring payment method
- Click Edit icon (pencil)
- Update Expiration Date Field:
- Enter new MM/YY
- You do NOT need the full card number
- You do NOT need the CVV
- Click Save
- Token remains the same, but expiration date is updated
Why This Works:
When cards expire, the card number doesn’t change – the issuer just sends a new card with a new expiration date. The token points to the card number, not the expiration date, so updating just the expiration date maintains the token’s validity.
Best Practice for Merchants:
- Set up alerts for cards expiring within 30 days
- Contact customers proactively: “Your card ending in 4242 expires next month. Please update your payment information.”
- Update expiration dates as soon as customer provides new card
- This prevents recurring billing failures and maintains revenue continuity
Limitations:
You cannot update:
- The card number itself (requires re-entry and new tokenization)
- The cardholder name
- The billing address (well, you can, but it’s separate from the card)
If the card number changed (lost/stolen, new account), you must:
- Add the new card as a new payment method
- Update recurring billing to use new payment method
- Delete old payment method
