PUT//
Use the /cardactions/cardswap endpoint to transfer digital wallet tokens to a new card with a different primary account number (PAN).
Header parameter
| Fields | Description |
|---|---|
| req-sys-id string Optional | Random pseudo-unique identifier of a request, used for troubleshooting between multiple parties. Usually a globally unique identifier (GUID). Allowable Values: 1–36 chars |
Request body
| Fields | Description |
|---|---|
| encrypted_card_data object Required | Contains details about the cards to be swapped. Allowable Values: new_card_token, new_pan_expiry, new_primary_account_number, old_card_token, old_pan_expiry, old_primary_account_number |
| encrypted_card_data.old_primary_account_number string Required | Primary account number for the existing payment card from which the digital wallet tokens are transferred. Allowable Values: 12–19 chars |
| encrypted_card_data.old_pan_expiry object Required | Specifies the expiry date for the card. Allowable Values: month, year |
| encrypted_card_data.old_pan_expiry.month string Required | Specifies the expiry month for the card in MM format. 01, for example.Allowable Values: Format: MM |
| encrypted_card_data.old_pan_expiry.year string Required | Specifies the expiry year for the card in yyyy format. 2024, for example.Allowable Values: Format: yyyy |
| encrypted_card_data.old_card_token string Required | Unique identifier of the card. Allowable Values: 1–36 chars |
| encrypted_card_data.new_primary_account_number string Required | Primary account number of the new card to which the digital wallet token are transferred. Allowable Values: 12–19 chars |
| encrypted_card_data.new_pan_expiry object Required | Specifies the expiry date for the card. Allowable Values: month, year |
| encrypted_card_data.new_pan_expiry.month string Required | Specifies the expiry month for the card in MM format. 01, for example.Allowable Values: Format: MM |
| encrypted_card_data.new_pan_expiry.year string Required | Specifies the expiry year for the card in yyyy format. 2024, for example.Allowable Values: Format: yyyy |
| encrypted_card_data.new_card_token string Required | Unique identifier of the new payment card token to which the digital wallet tokens are transferred. Allowable Values: 1–36 chars |
Response body
| Fields | Description |
|---|---|
| success boolean Conditionally returned | Indicates success if true, failure if false.Allowable Values: true, false |