- 接入指南
- 认证与签名
- 加密与解密
- Webhook 通知
- 错误码与重试
- 关于SDK
- 卡产品组
- 卡产品
- 卡钱包
- 卡钱包划转
- 卡钱包相关字典
- 卡钱包查询
- 卡片交易
- 卡钱包交易
- 卡钱包交易订单
- 卡钱包交易流水
- 卡片
卡片冻结
POST
/card-products/cards/freeze
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 | 同一幂等请求仍在处理中，或幂等键已用于不同请求。 |
请求参数
Header 参数
Body 参数application/json必填
示例
{
"cardInfoBizId": "VC_ABCDEF1234567890"
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.lampays.com/card-products/cards/freeze' \
--header 'X-API-VERSION: 1' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm;' \
--header 'X-Idempotency-Key;' \
--header 'Content-Type: application/json' \
--data '{
"cardInfoBizId": "VC_ABCDEF1234567890"
}'返回响应
🟢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
}
}修改于 2026-09-15 15:47:05