批量修改卡片状态

POST

/card-products/cards/status-operation-batches/create

批量冻结、解冻或注销指定卡片。返回的批次 ID 可用于查询任务进度和逐卡处理结果。

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

常见错误

错误码	触发条件
`REQUEST.CONFLICT`	幂等键已用于其他批量请求。
`REQUEST.CONFLICT`	同一幂等请求仍在处理中、幂等键已用于不同请求，或已超过 24 小时结果重放期；可通过 `X-Operation-Id` 查询处理状态。

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "operation": "FREEZE",
    "cardInfoBizIds": [
        "string"
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://api.lampays.com/card-products/cards/status-operation-batches/create' \
--header 'X-API-VERSION: 2' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm: RSA-SHA256' \
--header 'X-Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
    "operation": "FREEZE",
    "cardInfoBizIds": [
        "string"
    ]
}'

返回响应

🟢201Created

application/json

Created

Headers

Bodyapplication/json

示例

{
    "version": "string",
    "timestamp": 0,
    "success": true,
    "code": "string",
    "message": "string",
    "data": {
        "batchBizId": "CSOB_ABCDEF1234567890",
        "operation": "FREEZE",
        "status": "PROCESSING",
        "requestedCount": 10,
        "created": true
    }
}

修改于 2026-09-19 07:34:50

发卡任务明细（分页）

卡片状态任务明细（分页）