Adjust Card Limit

PUT

/api/v1/issuing/card/{cardNo}/limit

Change a card's cumulative spending ceiling (cardLimit). Only cards in ACTIVE status are eligible.

This call is accepted asynchronously. The response status is always PROCESSING, which only means the request was accepted; the card still shows its previous limit. The new limit takes effect when the card.updated webhook arrives. If the card network later rejects it, a card.operation.failed webhook is sent instead.

Errors: 404 when the card does not exist or is not yours; 409 when the card is not ACTIVE, or another operation on the same card is still in progress; 422 when the change is rejected downstream, with the reason in message.

No idempotency key is required: while an operation is in progress, a second one on the same card is refused with 409.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

Limit adjustment accepted

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠409Conflict

🟠422Rejected

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/api/v1/issuing/card/CD260811X9Y8Z7/limit' \
--header 'Content-Type: application/json' \
--data '{
    "cardLimit": "800.00",
    "reason": "Campaign budget raised"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "message": "success",
    "data": {
        "cardNo": "CD260811X9Y8Z7",
        "operation": "ADJUST_CARD_LIMIT",
        "status": "PROCESSING",
        "acceptedAt": "2026-09-23T04:11:02Z"
    }
}

Modified at 2026-09-30 09:29:55

Create Card Secure Session

Freeze Card