curl -X PATCH 'https://crypto-api.yativo.com/api/v1/card-issuer/admin/69ecc05a4fc8c9c148ed1a9a/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}'
{
"success": true,
"message": "Card limits updated",
"data": {
"program_id": "69ecc05a4fc8c9c148ed1a9a",
"card_limits": {
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}
}
}
{
"success": false,
"error": "INVALID_LIMIT",
"message": "max_virtual_per_customer must be 0–5"
}
{
"success": false,
"error": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error": "NOT_FOUND"
}
Card Issuer Program
Set Program Card Limits
Admin: set the per-customer card limit ceiling for an issuer program
PATCH
/
v1
/
card-issuer
/
admin
/
{programId}
/
card-limits
curl -X PATCH 'https://crypto-api.yativo.com/api/v1/card-issuer/admin/69ecc05a4fc8c9c148ed1a9a/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}'
{
"success": true,
"message": "Card limits updated",
"data": {
"program_id": "69ecc05a4fc8c9c148ed1a9a",
"card_limits": {
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}
}
}
{
"success": false,
"error": "INVALID_LIMIT",
"message": "max_virtual_per_customer must be 0–5"
}
{
"success": false,
"error": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error": "NOT_FOUND"
}
This is an admin-only endpoint. It sets the maximum number of cards each customer in the program can hold. Issuers cannot set per-customer limits above these ceilings.
string
required
The ID of the issuer program to update. Returned by
GET /v1/card-issuer/status as data.id.string
required
Bearer token:
Bearer YOUR_ACCESS_TOKENinteger
Maximum virtual cards allowed per customer. Must be 0–5. Default:
1.integer
Maximum physical cards allowed per customer. Must be 0–5. Default:
1.integer
Maximum total active cards (virtual + physical combined) allowed per customer. Must be 0–5. Default:
2. Platform hard cap is 5.curl -X PATCH 'https://crypto-api.yativo.com/api/v1/card-issuer/admin/69ecc05a4fc8c9c148ed1a9a/card-limits' \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
-H 'Content-Type: application/json' \
-d '{
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}'
{
"success": true,
"message": "Card limits updated",
"data": {
"program_id": "69ecc05a4fc8c9c148ed1a9a",
"card_limits": {
"max_virtual_per_customer": 3,
"max_physical_per_customer": 1,
"max_total_per_customer": 4
}
}
}
{
"success": false,
"error": "INVALID_LIMIT",
"message": "max_virtual_per_customer must be 0–5"
}
{
"success": false,
"error": "NO_CHANGES",
"message": "Provide at least one limit field to update"
}
{
"success": false,
"error": "NOT_FOUND"
}

