1. 卡片状态
Elaypay
  • 接入指南
  • 解密指南
  • 卡交易
    • 交易查询
      • Page Transactions
      • List Transactions
      • Get Transaction Detail
    • 交易字典
      • List Transaction Types
      • List Transaction Statuses
      • List Merchant Countries
      • List Fund Flow Types
  • 卡管理
    • 卡片查询
      • List Cards
      • Get Card
      • Reveal Sensitive Card
    • 开卡
      • Precheck Create Card
      • Create Card
      • Page Card Batch Items
      • Get Card Batch
    • 卡片设置
      • Update Card Spending Control
      • Update Card Remark
    • 卡片状态
      • Freeze Card
        POST
      • Unfreeze Card
        POST
      • Cancel Card
        POST
  • 参考数据
    • 商户数据
      • List Reference Merchants
      • Get Reference Merchant
    • 国家地区
      • Get Slash Countries
    • 消费控制
      • Get Slash Spending Restrictions
      • Get Slash Spending Presets
  • 卡产品
    • 产品组
      • Page Groups
      • List Groups
    • 产品查询
      • Page Products
      • List Products
      • Get Product Detail
    • 配置模型
      • Get Provider Product Config Schema
      • Get Provider Card Settings Schema
  • 钱包
    • 钱包查询
      • Page Wallets
      • List Wallets
      • Get Wallet
    • 账本
      • List Ledger
      • Page Ledger
      • Get Ledger
    • 资金划转
      • Transfer Out
      • Transfer In
    • 转账订单
      • List Transfers
      • Get Transfer
      • Page Transfers
      • Cancel
    • 转账字典
      • List Order Statuses
      • List Directions
      • List Approval Statuses
  1. 卡片状态

Freeze Card

POST
/api/v1/consumer/card-products/cards/freeze
Temporarily freezes an active card to block new authorizations until it is unfrozen.

Gateway Contract#

Chain: API
Portal: CONSUMER
JWT token enabled: false
Workspace kind: LIVE
Workspace portal: CONSUMER
Workspace permission: card:write
Rate limit: 120 / 60s
Rate limit strategy: IP

Common Errors#

CodeWhen
RESOURCE.NOT_FOUNDvirtual card not found
REQUEST.CONFLICTcard is not in a freezable state, a provider status operation is already in progress, or the card's linked Slash resource is unavailable

请求参数

Authorization
在 header 添加参数
X-Api-Key
示例:
X-Api-Key: ********************
Header 参数

Body 参数application/json必填

示例

返回响应

🟢200成功
*/*
OK
Body*/*

请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://api.elaypay.app/api/v1/consumer/card-products/cards/freeze' \
--header 'X-Timestamp;' \
--header 'X-Nonce;' \
--header 'X-Signature;' \
--header 'X-Signature-Algorithm;' \
--header 'X-Idempotency-Key;' \
--header 'X-Workspace-Id;' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "cardInfoBizId": "VC_ABCDEF1234567890"
}'
响应示例响应示例
{
    "version": "string",
    "timestamp": 0,
    "success": true,
    "code": "string",
    "message": "string",
    "data": {
        "bizId": "VC_ABCDEF1234567890",
        "cardBinGroupBizId": "CPG_ABCDEF1234567890",
        "cardBinProductBizId": "CBP_ABCDEF1234567890",
        "cardWalletBizId": "CW_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"
        },
        "providerLastOperationError": "Insufficient wallet balance",
        "providerOperationAttempts": 3,
        "providerLastOperationAt": 1713629600,
        "infoSyncStatus": {
            "code": "ACTIVE",
            "value": 35010102,
            "label": "Active"
        },
        "providerType": 10010105,
        "createdAt": 1713628800,
        "updatedAt": 1713629600
    }
}
修改于 2026-07-15 03:51:44
上一页
Update Card Remark
下一页
Unfreeze Card
Built with