Convert virtual to physical

POST

/cards/convert-to-physical

Last modified:2025-12-02 10:06:51

Converts a virtual card to a physical card. This initiates the conversion process and sends an OTP
to the customer's registered mobile number. The response includes a session ID that must be used
to complete the conversion via the complete conversion endpoint.

Request:

card_id: UUID of the virtual card to convert

idempotency-key header: UUID to ensure idempotency of the request

city: Delivery city for the physical card

Response:

session_id: Session ID (cardIssuanceId) to use for completing the conversion

Error Responses:

400 INVALID_INPUT: Invalid request body or parameters

400 INVALID_CITY: Invalid city provided

404 CARD_NOT_FOUND: Card does not exist

409 CARD_TYPE_CONFLICT: Card is already a physical card

412 CARD_STATUS_NOT_ALLOWED: Card is not in ACTIVE status

412 INVALID_CARD_STATUS: Card status is invalid for this operation

503 SERVICE_UNAVAILABLE: Service temporarily unavailable

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Default Response

Body

🟠400400

🟠401401

🟠403403

🟠404404

🟠405405

🟠409409

🟠410410

🟠412412

🟠422422

🟠429429

🔴500500

🔴501501

🔴503503

🔴504504

🔴505505

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/cards/convert-to-physical' \
--header 'idempotency-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "card_id": "66f6e46c-f6a1-4af8-a1bd-49666bc01304",
    "city": "string"
}'

Response Example

200 - Example 1

{
    "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82"
}

Modified at 2025-12-02 10:06:51

Verify card issuance OTP

Verify card conversion OTP