卡片冻结

异步冻结卡片。状态变为 FROZEN 后才会阻止新的授权；providerOperationStatus 为 STATUS_UPDATING 时，可轮询卡片详情查询进度。

本接口要求幂等键，重试同一业务操作时复用原值。

常见错误

错误码	触发条件
`RESOURCE.NOT_FOUND`	卡片不存在。
`CARD.OPERATION_IN_PROGRESS`	卡片正在冻结。
`CARD.ALREADY_FROZEN`	卡片已冻结。
`CARD.STATE_TRANSITION_NOT_ALLOWED`	卡片不处于 `ACTIVE` 状态。
`CARD.LINKED_RESOURCE_UNAVAILABLE`	发卡资源不可用。
`REQUEST.CONFLICT`	同一幂等请求仍在处理中，或幂等键已用于不同请求。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

*/*

Headers

Body*/*

示例

{
    "version": "string",
    "timestamp": 0,
    "success": true,
    "code": "string",
    "message": "string",
    "data": {
        "bizId": "VC_ABCDEF1234567890",
        "userCardProductGroupBizId": "UCPG_ABCDEF1234567890",
        "platformCardProductBizId": "PLCP_ABCDEF1234567890",
        "cardWalletBizId": "UCPGW_ABCDEF1234567890",
        "cardDisplayName": "Operations Card",
        "platformCardDisplayName": "Operations Card",
        "cardNetwork": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "cardType": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "currency": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active",
            "scale": 2,
            "isFiat": true,
            "isStablecoin": false
        },
        "maskedPan": "**** 4242",
        "last4": "4242",
        "status": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "providerOperationStatus": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "infoSyncStatus": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "providerType": 10010105,
        "createdAt": 1713628800000,
        "updatedAt": 1713629600000
    }
}

请求参数

请求示例代码

返回响应