Freeze Card

POST

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

Freeze a card. Only cards in ACTIVE status are eligible. A frozen card is refused for all new authorisations; transactions already authorised but not yet settled are unaffected and still settle.

This call is accepted asynchronously. The response status is always PROCESSING; the card becomes FROZEN when the card.updated webhook arrives. If the card network later rejects it, a card.operation.failed webhook is sent instead.

reason is required and is kept in PIK's audit trail.

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.

Request

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

Freeze accepted

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠409Conflict

🟠422Rejected

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/issuing/card/CD260811X9Y8Z7/freeze' \
--header 'Content-Type: application/json' \
--data '{
    "reason": "Suspicious activity reported by cardholder"
}'

Response Example

200 - 成功示例

{
    "code": 200,
    "message": "success",
    "data": {
        "cardNo": "CD260811X9Y8Z7",
        "operation": "FREEZE_CARD",
        "status": "PROCESSING",
        "acceptedAt": "2026-09-23T04:14:40Z"
    }
}

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

Adjust Card Limit

Unfreeze Card