量子卡

Card Resource

Example

{
    "id": "d8eda079-6ba7-409e-99c8-ab5f83566fbd",
    "accountId": "78ad30f2-5794-47c7-b413-62cc599ab203",
    "userName": "John Doe",
    "currency": "USD",
    "bin": "411111",
    "status": "ACTIVE",
    "cardLastFour": "4567",
    "label": "Personal Visa",
    "balanceId": "0d13f168-339b-4b74-a412-07a6ababcd9c",
    "budgetId": "c0598084-16d9-4426-b98e-382166afb0eb",
    "cardholderId": "4377d744-23cf-4c5e-9a39-34c70cf39c31",
    "createTime": "1756191281381",
    "cardAddress": {
        "addressLine1": "123 Main Street",
        "addressLine2": "Apt 4B",
        "city": "New York",
        "state": "NY",
        "country": "US",
        "postalCode": "10001"
    },
    "transactionLimits": [
        {
            "type": "LIFETIME",
            "value": "5000"
        }
    ],
   "cardStatusChangeRecordList": [
        {
            "accountId": "579e92e6-e126-4d2b-b464-54897a414080",
            "afterStatus": "Frozen",
            "beforeStatus": "Active",
            "cardId": "71ad58d8-9da2-4788-8d87-6d8bd1e6d41e",
            "operationTime": "1776160116145",
            "reasonCode": "3001",
            "requestUrl": "/open-api/v3/cards/71ad58d8-9da2-4788-8d87-6d8bd1e6d41e/freeze",
            "userId": "4fa1c488-c668-4f44-811c-b599b53deec0"
        }
    ]
}

Card Properties

id string required 唯一卡片标识 – 每张卡的全局唯一 ID

accountId string required 账户 ID – 关联的用户账户 ID

status string required 卡状态 – 卡当前的生命周期状态（例如 INACTIVE、CONTROL、ACTIVE、PENDING、FROZEN）。

Enum Value	Description
Active	启用，可使用
Inactive	已删除或已过期（卡已关闭）
Frozen	持卡人暂时冻结（卡暂停使用）
Control	因合规或风控被发卡方限制
Pending	等待激活

currency string required 币种代码 – 卡支持的币种（例如 CNY 人民币、USD 美元、EUR 欧元），遵循 ISO 4217 标准。

bin string required 卡 BIN – 卡号前 6-8 位，用于识别发卡机构和卡类型。

userName string required 用户名 / 持卡人姓名 – 持卡人的姓名，通常与身份证件姓名一致。支持中英文字符。

createTime string required 卡创建时间 – 卡生成时的时间戳。

cardLastFour string required 卡后四位 – 用于脱敏展示的卡号后四位字段。

cardMode string required 卡模式。

address Address optional 地址信息 – 持卡人地址详情。

label string optional 卡标签 – 用户自定义的卡备注或说明。

balanceId string optional 余额 ID – 关联的余额账户 ID，用于查询当前卡余额、交易记录及其他财务数据。

budgetId string optional 预算 ID – 关联的预算控制 ID，用于限制卡消费（例如月预算、分类预算）。

transactionLimits List<TransactionLimits> optional 交易限额信息 – 卡的消费限额详情。

Address Properties

addressLine1 string optional 地址第一行 – 地址的第一行，通常存储详细街道信息。

addressLine2 string optional 地址第二行 – 地址补充信息。

city string optional 城市 – 地址所在城市。

country string optional 国家 – 地址所在国家/地区，通常使用 ISO 3166-1 国家代码（例如 CN 中国，US 美国）。

postalCode string optional 邮编 – 邮政编码或 ZIP 码。

state string optional 州/省 – 国家内的次级行政区划。

TransactionLimits Properties

type TransactionLimitsTypeEnum optional 交易限额类型 – 定义限额维度的枚举：DAY（每日）、WEEK（每周）、MONTH（每月）、QUARTER（每季度）、YEAR（每年）、LIFETIME（卡生命周期）、TRANSACTION（单笔）、NA（不限）。

value string optional 交易限额值 – 具体的限额金额，以字符串存储以支持多币种（需结合 currency 字段解析）。

CardStatusChangeRecordList Properties

accountId string optional

afterStatus string optional

beforeStatus string optional

cardId string _optional_card id

operationTime string optional timestamp

reasonCode string optional

requestUrl string optional

userId string optional

PhysicalCardResource

Example

{
  "code": "000000",
  "message": "success",
  "data": {
    "id": "ba0a5c6d-ee96-4c44-82f1-dc306d325d8e",
    "accountId": "ba0a5c6d-ee96-4c44-82f1-dc306d325d8e",
    "cardId": "ba0a5c6d-ee96-4c44-82f1-dc306d325d8e",
    "shippingAddress": {
      "addressLine1": "123 Main Street",
      "addressLine2": "Apt 4B",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postalCode": "10001"
    },
    "phoneNumber": "13765987596",
    "email": "[email protected]",
    "phoneCountryCode": "86",
    "firstName": "John",
    "lastName": "Smith",
    "realName": "John Smith",
    "realFirstName": "John",
    "realLastName": "Smith",
    "idNumber": "A123456789",
    "idType": "PASSPORT",
    "dob": "1985-06-15",
    "expirationDate": "2026-12-31",
    "displayStatus": "ACTIVE",
    "batchNumber": "ba0a5c6d-ee96-4c44-82f1-dc306d325d8e",
    "cardStyle": "Plastic"
  }
}

PhysicalCardResource Properties

id string required 实体卡 ID – 实体卡的唯一标识

accountId string required 账户 ID – 关联的用户账户 ID

cardId string required 虚拟卡 ID – 关联的虚拟卡标识

shippingAddress AddressResource required 收货地址 – 实体卡的配送地址

phoneNumber string optional 电话号码 – 联系电话

email string optional 邮箱地址 – 联系邮箱

phoneCountryCode string optional 电话区号 – 电话号码的国家区号前缀

firstName string optional 名字 – 持卡人名字

lastName string optional 姓氏 – 持卡人姓氏

realName string optional 法定全名 – 持卡人的完整法定姓名

realFirstName string optional 法定名字 – 持卡人的法定名字

realLastName string optional 法定姓氏 – 持卡人的法定姓氏

idNumber string optional 证件号码 – 身份证明文件号码（例如护照号、身份证号）

idType string optional 证件类型 – 身份证明文件类型（例如 PASSPORT、DRIVING_LICENSE、NATIONAL_ID）

dob string optional 出生日期 – 持卡人的出生日期（格式：YYYY-MM-DD）

expirationDate string optional 到期日期 – 实体卡到期日期（格式：YYYY-MM-DD）

displayStatus string optional 展示状态 – 实体卡当前状态（例如 PENDING、PROCESSING、SHIPPED、DELIVERED、EXPIRED）

batchNumber string optional 批次号 – 实体卡的生产批次号

cardStyle string optional 卡样式 – 实体卡的设计/样式（例如 CLASSIC、PREMIUM、CUSTOM）

AddressResource Properties

addressLine1 string optional 地址第一行 – 收货地址的第一行，通常为街道详细信息

addressLine2 string optional 地址第二行 – 补充地址信息（例如房间号、公寓号）

city string optional 城市 – 收货地址所在城市

state string optional 州/省 – 收货地址所在州/省

country string optional 国家 – 收货地址所在国家/地区（ISO 3166-1 代码）

postalCode string optional 邮编 – 收货地址的邮政编码 / ZIP 码

CardPrivateInfo Resource

Example

{
  "pan": "3d91e3efd3bb64d8a5ba465470f4dc1973c5e951bea20b01ff7d1c1f90f4e32b",
  "cvv": "1f58406cc7d858578fedf4a9a9ae18a9",
  "expYear": "19980571355d04c6aef36001c878f994",
  "expMonth": "18fe21de46aea89042fdf7b311ced454",
  "bin": "49387519",
  "cardLastFour": "4425"
}

CardPrivateInfoProperties

pan string required 主账号号码 – 完整卡号（Primary Account Number），属于敏感信息，需要加密存储和传输。返回为 AES 加密的十六进制字符串。

cvv string required CVV – 卡安全码，用于验证持卡人实际持有该卡。属于敏感信息，返回为 AES 加密的十六进制字符串。

expYear string required 到期年份 – 卡的到期年份（例如 "2028"），返回为 AES 加密的十六进制字符串。

expMonth string required 到期月份 – 卡的到期月份（例如 "09" 表示九月），返回为 AES 加密的十六进制字符串。

bin string required 卡 BIN – 卡号前 6-8 位，用于识别发卡机构和卡类型信息。

cardLastFour string required 后四位 – 卡号后四位，用于脱敏展示和用户识别。

CardTransaction Resource

Example

{
    "id": "d8eda079-6ba7-409e-99c8-ab5f83566fbd",
    "accountId": "78ad30f2-5794-47c7-b413-62cc599ab203",
    "cardId": "0d13f168-339b-4b74-a412-07a6ababcd9c",
    "cardTransactionId": "c0598084-16d9-4426-b98e-382166afb0eb",
    "currency": "USD",
    "amount": "125.5",
    "fee": "3.25",
    "feeDetails": [
        {
            "amount": "3.25",
            "currency": "USD",
            "feeType": 2
        }
    ],
    "clientTransactionId": "client_txn_abc123def456",
    "type": 1,
    "status": "CLOSED",
    "merchantName": "Amazon.com",
    "mcc": "5399",
    "mccCategory": "Miscellaneous General Merchandise",
    "merchantCity": "Seattle",
    "merchantCountry": "US",
    "merchantState": "WA",
    "merchantZipcode": "98109",
    "merchantMid": "merchant_amazon_12345",
    "transactionTime": "1756191281381",
    "transactionCurrency": "USD",
    "transactionAmount": "125.5",
    "createTime": "1756191281381",
    "completeTime": "1767498148032",
    "detail": "Online purchase - Electronics",
    "businessCodeList": [1001],
    "direction": 1,
    "remark": null
}

CardTransaction Properties

id string required 交易 ID – 交易记录的唯一标识。

accountId string required 账户 ID – 与该交易关联的用户账户 ID。

cardId string required 卡 ID – 与该交易对应的卡唯一 ID。

cardTransactionId string required 卡交易 ID – 卡级别的唯一交易标识。

relatedCardTransactionId string required 关联卡交易 ID – 其他相关交易的 ID。

currency string required 币种 – 交易的最终结算或展示币种。

amount string required 交易金额 – 交易的最终结算金额。

fee string required 交易手续费 – 该交易产生的手续费总额。

feeDetails List<FeeDetail> optional 交易手续费详情 – 手续费明细列表，展示不同类型费用的拆分信息。

clientTransactionId string optional 客户端交易 ID – 调用方（客户端）传入的自定义交易标识，用于跨系统对账或业务跟踪。

type integer required 交易类型：取值：0:Credit, 1:Consumption, 2:TransferIn, 3:TransferOut, 9:Fee_Consumption, 10:Declined_Fee, 14:Reversal, 15:System_Fee

Enum Value	Description
Credit	退款交易
Consumption	卡消费
TransferIn	从 Infinity Account 转入卡
TransferOut	从卡转出到 Infinity Account
Fee_Consumption	交易授权手续费（auth fee）
Declined_Fee	授权失败交易产生的费用，按拒付率阶梯收费
Reversal	冲正交易
System_Fee	通道费用

status string required 交易状态 – 交易当前的生命周期状态：CLOSED、PENDING、FAIL

merchantName string optional 商户名称 – 交易中的对手方（商户/平台）名称。

mcc string optional 商户类别代码（MCC） – 用于标识商户行业的编码（例如 5411 表示超市，5812 表示餐厅）。

mccCategory string optional MCC 类别 – MCC 代码对应的行业类别名称（例如 MCC=5411 时，对应 “综合超市”）。

merchantCity string optional 商户城市 – 商户/平台所在的城市。

merchantCountry string optional 商户国家 – 商户/平台所在的国家/地区。

merchantState string optional 商户州/省 – 商户/平台所在的州/省。

merchantZipcode string optional 商户邮编 – 商户/平台地址的邮政编码。

merchantMid string optional 商户 ID（MID） – 用于区分不同商户归属的唯一商户标识。

transactionTime string required 交易时间 – 实际发生交易的时间。

transactionCurrency string required 原始交易币种 – 交易发生时的原始币种。

transactionAmount string required 原始交易金额 – 交易发生时的原始金额。

completeTime string 完成时间 – 交易完成的时间。

createTime string required 创建时间 – 系统生成该交易记录的时间。

detail string optional 交易详情 – 交易的补充描述信息。

remark string optional 交易失败原因 – 对交易失败原因的备注说明。

FeeDetail Properties

amount string required 金额 – 单一费用类型的具体金额。

currency string required 币种 – 该费用对应的币种。

direction integer required 交易方向：1 - 入账，2 - 出账

businessCodeList List<string> optional 业务代码标识。完整支持的业务代码及其含义可在 Business Code Reference 中查看。

feeType integer required 费用类型 – 费用类型：0: 平台结算费，1: Apple Pay 费用，2: ATM 取现费，3: 冲正费，4: 退款费。

CardBalanceNegativeResource

Example

{
    "code": "000000",
    "message": "success",
    "data": {
        "list": [
            {
                "card": {
                    "id": "d8eda079-6ba7-409e-99c8-ab5f83566fbd",
                    "accountId": "78ad30f2-5794-47c7-b413-62cc599ab203",
                    "userName": "John Doe",
                    "currency": "USD",
                    "bin": "411111",
                    "status": "ACTIVE",
                    "cardLastFour": "4567",
                    "label": "Personal Visa",
                    "balanceId": "0d13f168-339b-4b74-a412-07a6ababcd9c",
                    "budgetId": "c0598084-16d9-4426-b98e-382166afb0eb",
                    "cardholderId": "1963922322985988097",
                    "referenceId": "78ad30f2-5794-47r6-b413-62gh699ab203",
                    "createTime": "1710813276127",
                    "billingAddress": {
                        "addressLine1": "123 Main Street",
                        "addressLine2": "Apt 4B",
                        "city": "New York",
                        "state": "NY",
                        "country": "US",
                        "postalCode": "10001"
                    },
                    "transactionLimits": [
                        {
                            "type": "LIFETIME",
                            "value": "5000",
                            "currency": "USD"
                        }
                    ]
                },
                "cardWallet": {
                    "id": "92826c47-d1cd-475a-a131-81229b4b6814",
                    "accountId": "9f033297-7027-4039-aa1c-b5184586d6cc",
                    "createTime": "1736938719118",
                    "currency": "USD",
                    "walletType": 2,
                    "objectType": 2,
                    "available": "12.03"
                }
            }
        ],
        "total": 1
    }
}

card object required card – @see CardResources

cardWallet object required 币种 – @see CardWalletResources

InfinityAccountTransaction Resource

{
    "code": "000000",
    "message": "success",
    "data": {
        "id": "9392c37e-c3da-4cf9-b34d-d6e19748bc3f",
        "accountId": "d37deed7-f0e7-4635-a43a-781af0cb59f0",
        "currency": "USD",
        "amount": "1",
        "fee": "0",
        "type": 1,
        "businessCodeList": [
            1001
        ],
        "direction": 1,
        "status": "CLOSED",
        "createTime": "1710813276127"
    }
}

InfinityAccountTransaction Properties

id string required 交易 ID – 交易记录的唯一标识。

accountId string required 账户 ID – 与该交易关联的用户账户 ID。

currency string required 币种 – 交易的结算或展示币种。

amount string required 交易金额 – 交易的结算金额。

fee string required 交易手续费 – 该交易产生的手续费总额。

type integer required 交易类型 – 表示不同业务含义的交易类型编码。

Transaction type mapping:
0 - 外部充值到账户
1 - 开卡费
2 - 从 group 转出到 infinity account
3 - 从卡转出到 infinity account
4 - 转入 infinity account
5 - 从 infinity account 转出
7 - 从粒子理财转入
9 - 从 qbit USD wallet 转入
10 - 充值到 group
11 - 充值到卡
12 - 从 global account 转入
13 - 转出到 global account
14 - 从主账户转入（主到子）
15 - 转出到主账户（子到主）
17 - 清算费
18 - Infinity account 月账单扣费

status string required 交易状态 – 交易当前的生命周期状态。

createTime string required 创建时间 – 系统生成该交易记录的时间。

transactionDisplayId string optional 交易展示 ID – 用于展示的交易标识。

businessCodeList List<Integer> optional 业务代码标识。完整支持的业务代码及其含义可在 Business Code Reference 中查看。

direction Integer optional 交易展示 ID – 用于展示的交易标识。

Budget Object

Example Budget Object

{
    "id": "e9561c9f-a7f6-4356-b2fe-4a4984c33c01",
    "accountId": "c83929c5-4ff3-42d4-af6d-56043022ebad",
    "createTime": "1758005368531",
    "name": "test name11222322222333",
    "balance": {
        "id": "a95b3d17-c8a4-4036-9898-13123d47c79f",
        "available": "0.00000000",
        "currency": "USD"
    },
    "status": "INACTIVE"
}

Budget Attributes

id string 预算的 UUID。

accountId string 账户的 UUID。

createTime string 创建时间戳 – 预算创建时的时间戳。

name string 预算名称 – 预算的名称。

balance object 预算余额。
- id string 余额的 UUID。
- available string 可用余额 – 当前可用余额金额。
- currency string 余额币种。

status string 预算对象状态。可选值：ACTIVE、INACTIVE、FROZEN

BudgetTransaction Object

Example BudgetTransaction Object

{
  "id": "4f6d3e91-b8d0-4a7a-9a60-94c8e3c5f731",
  "accountId": "cae9efe2-b577-4632-8c57-8822ddb8542a",
  "budgetId": "b2312eab-8b13-40c7-a7e2-221ef79cfd09",
  "cardId": "1a9e92d7-1d12-4a6b-9b5b-9f2cb2d6a120",
  "amount": "200.00",
  "fee": "5.00",
  "feeDetails": [
    {
      "amount": "5.00",
      "currency": "USD",
      "feeType": "0"
    }
  ],
  "clientTransactionId": "txn_custom_123456",
  "transactionDisplayId": "TXN-20250911-0001",
  "type": "TransferIn",
  "status": "Closed",
  "transactionTime": "1755498145103",
  "detail": "Card payment for order #789"
}

BudgetTransaction Attributes

id string 交易的 UUID。

accountId string 账户的 UUID。

budgetId string 预算的 UUID。

cardId string 卡的 UUID。

amount string 交易金额 – 交易金额。

fee string 交易手续费 – 与该交易相关的手续费。

feeDetails List<object> 交易手续费详情。
- amount string 金额大小 – 该费用明细的具体金额。
- currency string 币种代码 – 该费用明细金额对应的币种代码。
- feeType string 费用类型 – 可选值：
  - 0: 开卡制作费
  - 1: 寄卡费

clientTransactionId string 用户自定义交易 ID – 用户提供的自定义交易 ID。

transactionDisplayId string 交易展示 ID – 用于展示交易的 ID。

type string 交易类型 – 交易的类型。

Code	Type	Description
0	TransferIn	从 Infinity Account 转入预算
1	TransferOut	从预算转出到 Infinity Account
2	CreateCardFee	开卡费
3	Consumption	卡消费
4	Refund	退款交易
5	FeeCredit	退款交易产生的费用
6	Fee_Consumption	交易授权手续费（auth fee）
7	Declined_Fee	交易授权失败产生的费用
8	Reversal	冲正交易

status string 交易状态 – 交易状态。

transactionTime string 交易时间戳 – 表示交易发生时间的时间戳。

detail string 交易详情 – 关于交易的补充详情。

Card Wallet Resource

Example

{
    "id": "1f74664d-7680-4038-ac0f-16e62d7d0372",
    "accountId": "1f74664d-7680-4038-ac0f-16e62d7d0372",
    "createTime": "1755498145103",
    "currency": "USD",
    "available": "12.03",
    "walletType": 0
}

Card Wallet Properties

id string required 为该实体生成的唯一 ID – Card Wallet Resource 实体的全局唯一标识。

accountId string required Account 的 UUID – 与卡钱包关联的账户 ID（UUID 格式）。

createTime string optional 创建时间 – 卡钱包创建时的时间戳。

currency string required 币种代码 – 卡钱包支持的币种，遵循 ISO 4217 标准（例如 USD 美元、EUR 欧元、CNY 人民币）。

available string required 可用余额 – 卡钱包中的可用余额金额，以字符串形式存储以支持精确金额表达和多币种。

walletType string required 钱包类型 – 定义卡钱包类别的枚举，可选值如下：

0: Infinity account wallet
1: Budget wallet
2: Prepaid card wallet

Card Bin Resource

Example

{
    "id": "bin-123e4567-e89b-12d3-a456-426614174000",
    "bin": "411111",
    "type": "PrepaidCard",
    "currencies": ["USD", "EUR", "CNY"],
    "network": "VISA",
    "verification": {
        "avs": true,
        "threeDs": false
    },
    "purchaseLimit": {
        "day": "5000",
        "single": "1000",
        "lifetime": "/"
    },
    "supportPhysicalCard": true
}

Card Bin Properties

id string required bin 的 ID – Card Bin 记录的唯一标识。

bin string required 银行识别号（BIN） – 卡号前 6 位，用于识别发卡机构和卡属性。

type string required CardBin 的类型 – BIN 的分类，可选值：

"PrepaidCard": 预付卡类型 bin
"BudgetCard": 预算卡类型 bin

currencies List<string> required 卡基础币种 – 该 BIN 下卡支持的基础币种列表（遵循 ISO 4217 标准，例如 "USD"、"EUR"）。

network string required 卡网络 – 与该 BIN 关联的支付网络（例如 VISA、MasterCard）。

verification CardBinVerification required 校验信息 – 包含该 BIN 下卡的验证配置。

purchaseLimit CardBinPurchaseLimit required 消费限额 – 定义该 BIN 下卡的消费限制。

supportPhysicalCard Boolean required 是否支持实体卡 – 表示该 BIN 下的卡是否支持实体卡发卡（true = 支持，false = 不支持）。

CardBinVerification Properties

avs Boolean required 是否支持 AVS 校验 – 表示该 BIN 下的卡是否启用地址验证服务（AVS）（true = 支持，false = 不支持）。

threeDs Boolean required 是否支持 3DS 验证 – 表示该 BIN 下的卡是否启用 3-D Secure（3DS）认证（true = 支持，false = 不支持）。

CardBinPurchaseLimit Properties

day string required 每日消费限额 – 该 BIN 下卡每日累计最大消费限额。使用 "/" 表示不限额。

single string required 单笔消费限额 – 该 BIN 下卡单笔交易的最大消费限额。使用 "/" 表示不限额。

lifetime string required 生命周期消费限额 – 该 BIN 下卡在整个生命周期内的累计总消费限额（时间永不过期）。使用 "/" 表示不限额。

Consumption Scenario Resource

Example

{
    "id": 42,
    "name": "Amazon"
}

Consumption Scenario Properties

id Integer required 交易场景 ID – 交易消费场景的唯一数字标识。

name string required 交易场景名称 – 交易消费场景的描述名称（例如 "TikTok"、"线下支付"、"Amazon"）。

Cardholder Object

Example Cardholder Object

{
  "id": "1967846523043602433",
  "status": "ACTIVE",
  "accountId": "ab892db2-cb95-4794-a481-013585e15ed2",
  "firstName": "xu",
  "lastName": "mingru",
  "userName": "xu mingru",
  "email": "[email protected]",
  "phoneCountryCode": "86",
  "phoneNumber": "19921638850",
  "cardBinList": [
    "1871360496083530000",
    "1871360596906217473",
    "1871360464026470000",
    "1871360899013545985"
  ]
}

CardholderResource Attributes

id string 持卡人 ID。

status string 持卡人状态（例如 PENDING、ACTIVE、INACTIVE）。

accountId string Account 的 UUID。

firstName string 用户名字。仅允许英文字母（A–Z, a–z）。示例：John

lastName string 用户姓氏。仅允许英文字母（A–Z, a–z）。示例：Smith

userName string 持卡人的用户名。

email string 用户邮箱地址。

phoneCountryCode string 持卡人手机的国际区号，仅数字，不含 "+"，长度 ≤ 3。示例：86

phoneNumber string 不含国家区号的手机号，长度 ≤ 15。示例：13800138000

rejectReason string 拒绝原因

cardBinList List<string> 卡 BIN 列表。

address Address optional 地址信息 – 持卡人地址详情。

Address Properties

addressLine1 string optional 地址第一行 – 地址的第一行，通常存储详细街道信息。

addressLine2 string optional 地址第二行 – 地址补充信息。

city string optional 城市 – 地址所在城市。

country string optional 国家 – 地址所在国家/地区，通常使用 ISO 3166-1 国家代码（例如 CN 中国，US 美国）。

postalCode string optional 邮编 – 邮政编码或 ZIP 码。

state string optional 州/省 – 国家内的次级行政区划。

3DS Resources

Example


{
  "cardId": "d8eda079-6ba7-409e-99c8-ab5f83566fbd",
  "accountId": "d8eda079-6ba7-409e-99c8-ab5f83566fbd",
  "currency": "USD",
  "amount": "159.99",
  "cardNumber": "4111********1234",
  "otp": "654321",
  "detail": "Online shopping at Electronics Store",
  "expireTime": "300"
}

3DS Properties

cardId string required 卡 ID – 卡的标识

accountId string required 账户 ID – 关联的账户标识

currency string optional 消费币种 – 消费交易使用的币种

amount string optional 消费金额 – 消费的金额

cardNumber string optional 卡号 – 如果为空则根据 cardId 自动获取

otp string required OTP 验证码 – 用于校验的一次性密码

detail string optional 消费场景 – 描述消费上下文的详情

expireTime string optional 过期时间 – OTP 失效前的持续时间（秒）