Freeze, unfreeze, and reissue cards. Note: reissuing with reuse_pan: false auto-terminates the existing card.
curl --request POST \
--url https://api.example.com/api/v3/user/routable-cards/reissue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"api_key": "YOUR_API_KEY",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"id": "rcrd-417b1398-8eff-4db4-a810-1ffa3dc24c4a",
"card_type": "physical",
"terminate_old_card": true,
"reuse_pan": false
}
'{
"status": "success",
"message": "operation completed",
"data": {
"items": [
{
"id": "rcrd-9a117b23-cc90-d1ef-8f3a-2b1c0e444f2d",
"card_type": "physical",
"last_four": "4242",
"status": "unactivated",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"business_id": "buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e",
"created_at": "2026-04-16T12:34:56.000Z"
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 100,
"sort": "created_at:desc",
"search": "jane"
}
}
}Documentation Index
Fetch the complete documentation index at: https://developers.ingopayments.com/llms.txt
Use this file to discover all available pages before exploring further.
Program API key identifying your integration. Pass as the api_key HTTP header (preferred) or as an api_key field in the JSON request body. Required on every request in addition to the HMAC Authorization header.
Identifier of the target user. Required when the endpoint operates on a specific user.
"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"
Identifier of the target card.
"rcrd-9a117b23-cc90-d1ef-8f3a-2b1c0e444f2d"
True to reuse the same PAN on the reissued card, false to assign a new PAN.
Program API key. Accepted either in the api_key HTTP header or as this body field.
Short reason code accompanying the state change (optional).
Free-form reason describing why the state change occurred.
When reissuing with a new PAN, whether to terminate the replaced card.
Shipping address object. Required for physical card issuance.
Hide child attributes
ISO 3166-2 two-letter state code.
5-digit US ZIP.
ISO 3166-1 alpha-2 country code.
Success.
success "operation completed"
Endpoint-specific payload; shape varies per operation.
Hide child attributes
Hide child attributes
Routable card id; prefix rcrd-.
"rcrd-9a117b23-cc90-d1ef-8f3a-2b1c0e444f2d"
physical, virtual "4242"
unactivated, active, suspended, terminated, limited User entity id; prefix user-.
"user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef"
Business entity id; prefix buss-.
"buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e"
"2026-04-16T12:34:56.000Z"
curl --request POST \
--url https://api.example.com/api/v3/user/routable-cards/reissue \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'api_key: <api-key>' \
--data '
{
"api_key": "YOUR_API_KEY",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"id": "rcrd-417b1398-8eff-4db4-a810-1ffa3dc24c4a",
"card_type": "physical",
"terminate_old_card": true,
"reuse_pan": false
}
'{
"status": "success",
"message": "operation completed",
"data": {
"items": [
{
"id": "rcrd-9a117b23-cc90-d1ef-8f3a-2b1c0e444f2d",
"card_type": "physical",
"last_four": "4242",
"status": "unactivated",
"user_id": "user-8f3a2b1c-0e44-4f2d-9a11-7b23cc90d1ef",
"business_id": "buss-2ef94c60-5a11-4d72-a3c1-5be7fab0123e",
"created_at": "2026-04-16T12:34:56.000Z"
}
],
"pagination": {
"page": 1,
"per_page": 25,
"total": 100,
"sort": "created_at:desc",
"search": "jane"
}
}
}