# Migration of virtual to physical card

## Introduction

A new feature has been introduced in the system to allow users to migrate a virtual card to a physical card while retaining the same card details.

## The flow

Below you can find the flow details**:**

1. The user calls the Update Card API with the newly introduced parameter <mark style="color:green;">`change_to_physical`</mark> = true.
2. The system updates the card status reason code to <mark style="color:green;">`AT`</mark> – <mark style="color:green;">Active Transition</mark>, and the fulfillment status becomes <mark style="color:green;">`CREATED`</mark> .
3. Once the embossing of the physical card is generated, the status moves to  <mark style="color:green;">`ORDERED`</mark>  . After completing these steps, user needs to manually update the card status to  <mark style="color:green;">`A0`</mark> – <mark style="color:green;">Active Initial</mark>, which update the card type from VIRTUAL to PHYSICAL.

**Restrictions During Transition:**

1. While in the transition period, the status reason can only be changed to <mark style="color:green;">`ST`</mark> <mark style="color:green;"></mark><mark style="color:green;">– Suspended Transition</mark>, indicating that the card is temporarily blocked during migration.
2. If the user wishes to permanently block the card, it is allowed at any time during the transition.
3. While the card is in the transition period, authorization settings will be restricted, preventing specific transactions until the migration to physical is fully completed.

## API changes

The following  API changes added:

**1.** [**Update Card**](https://portal.stg.platform.ae-1.nymcard.com/default/documentation/02_api_specs#tag/Cards/operation/updateCard) **API (PUT /v1/cards/{id})**

* New Parameter: "<mark style="color:green;">`change_to_physical`</mark>" (Boolean)
* Allows the user to initiate the virtual-to-physical card migration.

**2.** [**Update Card Authorization Settings**](https://portal.stg.platform.ae-1.nymcard.com/default/documentation/02_api_specs#tag/Cards/operation/upsertCardAuthSettings) **API (PUT /v1/cards/{id}/authsettings)**

* Restriction: Users cannot change the card’s authorization settings during the transition period.

**3.** [**Change Card Status**](https://portal.stg.platform.ae-1.nymcard.com/default/documentation/02_api_specs#tag/Cards/operation/changeCardStatus) **API (PUT /v1/cards/{id}:statuschange)**

* New status codes introduced:
  * AT – Active in Transition (Card is in migration phase).
  * ST – Suspended in Transition (Card is temporarily blocked during migration).

**4.** [**Card Products**](https://portal.stg.platform.ae-1.nymcard.com/default/documentation/02_api_specs#tag/Card-Products) **APIs Updates:**

* New parameter: "<mark style="color:green;">`virtual_to_physical_expiry_duration`</mark>"
* Allows configuration of the maximum duration allowed before the virtual card expires during migration.

For more information refer to the [API catalog](https://portal.stg.platform.ae-1.nymcard.com/default/documentation/02_api_specs).

\
\ <br>