Usecase: Issue a Card with one of the Card Programs

a. Issue a Debit Card

Sandbox Simulation DataResult

Make a request to POST /v1/customer/id/<id>/issuance/card endpoint to issue a card with required nodes.

Required Fields:


"cardProgram": "<cardProgram-id>",


"account.id": "<account-id>",


"type": "DEBIT" / "PREPAID" (mandatory if cardProgram is not provided),


"shippingDetail": "<object>" (required for digital first and physical card programs),


"issuanceType": "DIGITAL" / "DIGITAL_AND_PHYSICAL" (applicable for digital first or physical card programs)

Call GET /v1/customer/id/<id>/issuance/card endpoint to get details of Debit Card.

For Digital First Card Program,


Card is issued in PENDING status.


Within a minute, Card is marked as ACTIVE. This is an immediate action, you directly get the debit card in ACTIVE status, which is valid only for Digital First Card Programs.


Important Fields:


“status": "ACTIVE",


"statusReason": "Activated Successfully",


"shippingDetail.status": "Delivered",


"properties.cardPresentEnabled": "False"

For Digital Card Program,


Card is issued in PENDING status.


Within a minute, Card is marked as ACTIVE.


Important Fields:


“status": "ACTIVE",


"statusReason": "Activated Successfully",


"properties.cardPresentEnabled": "False"

For Physical Card Program,


Card is issued in PENDING status.


Within 15 minutes, Card is marked as SHIPPED.


Important Fields:


“status": "SHIPPED",


"statusReason": "Debit Card Shipped"


After 1 minute, the status of debit card will be updated to ACTIVE.


Important Fields:


“status": "ACTIVE",


"statusReason": "Activated Successfully"

b. Issue a Prepaid Card

Sandbox Simulation DataResult

Make a request to POST /v1/customer/id/<id>/issuance/card endpoint to issue a prepaid card with required nodes.

"cardProgram": "<cardProgram-id>",


"type": "DEBIT" / "PREPAID" (mandatory, if cardProgram is not provided),


"shippingDetail": "<object>" (required, for digital first and physical card programs),


"issuanceType": "DIGITAL" / "DIGITAL_AND_PHYSICAL" (applicable when cardProgram is digital first)

Call GET /v1/customer/id/<id>/issuance/card endpoint to get details of Prepaid Card.

For Digital First Card Programs,


Card is issued in PENDING status.


Within a minute, Card is marked as ACTIVE. This is an immediate action, and the prepaid card is directly available in ACTIVE status (applicable only for Digital First Card Programs).

Important Fields:


“status": "ACTIVE",


"statusReason": "Activated Successfully",


"shippingDetail.status": "Delivered",


"properties.cardPresentEnabled": "False"

For Digital Card Programs,


Card is issued in ACTIVE status.

Important Fields:


“status": "ACTIVE",


"statusReason": "Activated Successfully",


"properties.cardPresentEnabled": "False"


Did this page help you?
.readme-logo { display: none !important; }