Card reissuing
Similar to your embossing configuration, you need to personalize the card reissuing configuration and process for your brand as every brand has different reissue reasons and associated costs. After setting up your card program, meet with your Pismo representative to configure this.
You can call the following card API endpoints to view your reissuing configuration and reissue a card:
- Get card reissue reasons—Issuer-defined card reissue reasons and actions
- Reissue card—Reissue a card. Reissuing a physical card initiates the embossing process.
Transferring PIN, tokens, and PAN when a card is reissued
When creating or reissuing a Pismo card, a new PAN and PIN are generated randomly. For a new card's PIN to be the same as the old card's, you must manually change the new card's password to the old card's password.
To transfer a card's password (PIN):
- Call Get card password to get the old card's password.
- Call Change card password to update the new card's password to the old card's password.
To transfer a card's tokens:
- Call Reissue card and set the
update_tokens
parameter totrue
. - Alternatively, reissue the card and then call Transfer card tokens .
There currently is no way to transfer a card's PAN to a reissued card.
Card reissue scenarios and statuses
Scenario 1 - physical:
- Card created (
CREATED
) and activated (NORMAL
) - Card reissued with
must_block
=true
(CANCELLED
). (The reissue reason object contains themust_block
field). - New card created (
CREATED
) and activated (NORMAL
)
Scenario 2 - physical:
- Card created (
CREATED
) and activated (NORMAL
) - Card reissued with
must_block
=false
(REISSUED
) - New card created (
CREATED
) and activated (NORMAL
) - Old card cancelled (
REISSUED
,NORMAL
,BLOCKED
,PENDING
, orWARNING
) > (CANCELLED
)
Scenario 3 - physical:
- Card created (
CREATED
), activated (NORMAL
), and blocked (BLOCKED
) - Card reissued with
must_block
=false
, card remains with the same status (BLOCKED
) - New card created (
CREATED
) and activated (NORMAL
) - Old card canceled (
REISSUED
,NORMAL
,BLOCKED
,PENDING
, orWARNING
) > (CANCELED
)
Scenario 4 - virtual:
- Card created and activated automatically (
NORMAL
) - Card reissued with
must_block = true
ormust_block
=false
(CANCELLED
). (Themust_block
flag is a field in the reissue reason object.) - New card created (
CREATED
) and activated (NORMAL
)
Scenario 5 - physical:
- Card created (
CREATED
) and activated (NORMAL
) - Card in some final status (for example,
THEFT
) - Card reissued
- New card created (
CREATED
) and activated (NORMAL
) - Old card stays with the same status (
THEFT
)
Note: For reissued cards that remain in the same status, the card update event is not sent, i.e., scenarios 3 and 5.
Reissuing card to a noname card
You can use the Associate noname card with customer endpoint to reissue a card to a noname card as long as that noname card has not previously been associated and still has an
UNBOUND
status.
Card reissue reasons
You can create your own reasons for reissuing a card. Each reason has a reason_id
field identifier that you can pass when calling the Reissue card endpoint. You can configure your initial reasons as part of the beginning setup process with your Pismo representative. To get your organization's reasons, call Get card reissue reasons.
To create a reason for reissuing a card open a JIRA ticket with type = Settings and submit the following fields:
- organization ID—Your organization/tenant ID.
- reason—Reason description.
- type—Issuer defined reissue reason enum value. For example,
FRAUD
. - must_block—Is the card canceled at reissue time or can it transact until the new card is activated?
- must_charge—Is reissue charged? This field is for information only—only issuers can make debit entries to a customer's account.
- cost—Reissue cost value. This field is for information only—only issuers can make debit entries to a customer's account.
Mastercard automatic card reissue updates
This service is offered in partnership with Mastercard to simplify a customer's life. When a new customer card number is issued, it is automatically updated on the various websites, applications, and digital services where the customer already has a record with the old card.
Updated about 23 hours ago