Freeze and unfreeze cards

Freeze a card

After a card is frozen, it can no longer be used for normal purchase transactions, but refund-like incoming postings are not affected.

Common freeze scenarios

• Card information may have been exposed
• Abnormal transactions or unusual card usage are detected
• Card usage needs to be temporarily suspended
• The merchant proactively performs risk control

Status changes after freezing

After a card is frozen, its status changes from ACTIVE to FROZEN.

How to freeze

Through the Dashboard:

1. Go to the card details page
2. Click “Freeze card”
3. Complete the operation in the confirmation dialog

Through the API:

Initiate the freeze operation through the corresponding endpoint. After the status is updated, the card enters the frozen state.

System-frozen cards

In some risk control scenarios, the system may automatically freeze a card.

System freeze behavior

• System freezing is usually triggered by risk control reasons
• The status after system freezing is SYSTEM_FROZEN
• In this state, the card can no longer be used for normal purchases
• Manually unfreezing a system-frozen card is not currently supported

Unfreeze a card

After confirming that the risk has been cleared and the card can be used again, a frozen card can be unfrozen.

Unfreeze conditions

• The current card status is FROZEN
• The card has not expired
• The card is not in the SYSTEM_FROZEN status

Status changes after unfreezing

After unfreezing, the card status changes from FROZEN back to ACTIVE, and the card can be used again for normal purchases.

How to unfreeze

Through the Dashboard:

1. Go to the card details page
2. Click “Unfreeze card”
3. Complete the operation in the confirmation dialog

Through the API:

Initiate the unfreeze operation through the corresponding endpoint. After the status is updated, the card returns to normal.

Operation limits

• Freeze and unfreeze operations usually take effect after submission
• Expired cards can no longer be unfrozen
• If a frozen card expires while frozen, it cannot be unfrozen
• Manually unfreezing system-frozen cards is not currently supported
• Terminated cards can no longer be unfrozen