Get Started
For developers
Card replacement
The platform provides card replacement feature to replace the terminated card. A terminated card (personalized or non personalized) can be replaced with a non-personalized bulk card or with a personalized card when requested by the API user.
The API user can raise a card replacement request for a terminated card due to any reason, e.g. stolen, lost, damaged, expired, etc. The replaced card will take the place of the original terminated card and will be linked to the existing account of the original card instead of creating a new account.
Replace a card with a personalized card
A terminated (non-personalized or personalized) card can be replaced with a personalized card when requested by the API user. After the successful card replacement the replaced card takes the place of the original terminated card and is linked to the existing account of the card being replaced.
Please note:
1. A new PAN (Primary Account Number), PIN (Primary Identification Number), CVV2 (Card Verification Value 2) & expiry date is generated and instead of creating a new account this new card is linked to the original card’s account.
2. For a successful card replacement, following details required.
- original card product ID in "card_product_id"
- original user ID in "user_id"
- original card ID in "reference_card_id"
You can replace a card with a personalized card by sending a POST request to /cards endpoint as shown below.
Replace a card with a non-personalized bulk card
nCore supports feature to replace the terminated card (from a personalized or non-personalized card to a non-personalized bulk card) when requested by the API user. The API user can raise a card replacement request for a terminated card due to any reason e.g. stolen, lost, damaged, expired etc.. The replaced card takes the place of the original terminated card and is linked to the existing account of the original card instead of creating a new account.
Please note:
To replace a terminated card (personalized or non-personalized) with a non-personalized card you require:
- Please make sure that the original card's card product ID = bulk issuance's card product ID.
- Get a card created in bulk issuance you want to link/replace by sending a GET request to /cards endpoint.
- provide terminated card id in “reference_card_id” field when replacing a card.
The platform treats it as a card replacement request and links the non-personalized card provided in the request with the account of the original card present in field "reference_card_id".
You can send a POST request to /cards/{id}:replace endpoint; where id is the non-personalized card id you want to replace the terminated card with.
Last modified 4mo ago