Renewal
Renewal
A card is renewed when the existing card is about to expire. The card number (PAN) and the PIN remain the same. The expiry date and the CVV2/CVC2 are regenerated.
INITIAL or ACTIVE_LIMITED status, depending on programme configuration. See Card Version Status for details.Reissue
Reissue
A card is reissued when the existing card has either worn out or broken. The card number (PAN) remains the same. The expiry date and the CVV2/CVC2 are updated.
By default, the PIN remains the same. However, you can modify this behaviour via the pinStatus parameter:
- Specify
GENERATEDto set a random PIN. - Specify
WAITINGto set the PIN later.
Related API Endpoint: Reissue card
ACTIVE version remains ACTIVE. It transitions to CLOSED only when a newer version is activated. See Card Version Status for the coexistence rules and a worked example.Replacement
Replacement
A card is replaced when it is lost, stolen, or compromised for fraudulent activity. The card number (PAN), the expiry date, and the CVV2/CVC2 are updated.
By default, the replaced card has a system-generated PIN. However, you can modify this behaviour via the pinStatus parameter. To manually set the PIN later, specify WAITING.
Related API Endpoint: Replace card

