1. 卡业务
OpenAPI
  • 开发指南
    • 开发前必读
    • 申请API Key 与 API Secret
    • 错误码指引
    • 接口签名
    • 接口响应安全校验
    • 多语言
    • 时区相关
    • 更新日志
    • Webhook Beta
    • 业务幂等相关
  • API 使用指南
    • 公共服务
      • 基础配置信息
    • 用户
      • 用户注册
      • 用户列表
      • 用户详情
      • 获取KYC Token
      • 获取KYC H5链接
    • 卡业务
      • 卡渠道列表
        GET
      • 实体卡邮寄地址列表
        GET
      • 创建实体卡邮寄地址
        POST
      • 修改实体卡邮寄地址
        PUT
      • 删除实体卡邮寄地址
        DELETE
      • 申请卡
        POST
      • 激活实体卡
        POST
      • 卡列表
        GET
      • 卡详情
        GET
      • 卡CVV信息
        GET
      • 卡交易列表
        GET
      • 卡交易详情
        GET
      • 重置免密支付金额
        POST
      • 重置实体卡 PIN
        POST
      • 冻结卡
        POST
      • 解冻卡
        POST
    • 钱包
      • 钱包列表
      • 链列表
      • 创建钱包链地址
      • 钱包详情
      • 链上收款人列表
      • 链上收款人详情
      • 创建链上收款人
      • 更新链上收款人
      • 删除链上收款人
      • 创建钱包提现交易
      • 取消钱包提现交易
      • 钱包站内划转
      • 钱包划转到卡
      • 钱包交易列表
      • 钱包交易详情
    • 服务调试
      • GET请求调试
      • POST请求调试
  • 数据模型
    • response.Response
  1. 卡业务

卡列表

UAT环境
https://uat.bkj.com/openapi/v1
UAT环境
https://uat.bkj.com/openapi/v1
GET
https://uat.bkj.com/openapi/v1
/card/list
响应字段类型必含标题说明
idstring是列表ID列表ID
created_atstring是创建时间创建时间
update_atstring是更新时间更新时间
remarksnull是备注备注
account_idstring是AccountID账户AccountID
labelstring是标签标签
currencystring是币种币种
last4string是last4卡号后四位
first8string是first8卡号前八位
statusstring是虚拟卡状态active:正常,deleted:已删除,frozen:冻结,opening:开卡中,processing:待激活,pre_delete:预删除,expired:卡过期,blocked:被锁定,processing_frozen:冻结中,processing_unfrozen:解冻中,pre_producing:预制卡中,producing:制卡中,shipping:邮寄中,activate_reviewing:激活审核中
velocity_limit_windowstring是限额类型-
velocity_amount_limitstring是限额金额-
typestring是类型physical:实体卡,virtual:虚拟卡
channel_balancestring是渠道方余额渠道方余额
first_namestring是持卡人的名-
last_namestring是持卡人的姓-
physical_statusstring是实体卡状态active:已激活,processing:待激活,pre_producing:预制卡中,producing:制卡中,shipping:邮寄中,activate_reviewing:激活审核中
raw.associationstring否-关联卡组织(如Visa/Mastercard)
raw.balanceCurrencystring否-余额币种
raw.billingCurrencystring否-账单币种
raw.caBalancestring是-CA余额
raw.cardBalancestring是-卡余额
raw.cardEmbossingNamestring是-卡上压印名称
raw.cardHolderstring是-持卡人名称
raw.cardImagestring是-卡面图片
raw.cardNostring是-完整卡号
raw.cardStatusstring是-卡片状态
raw.cardTypestring是-卡片类型
raw.physicalCardStatusstring是-实体卡状态
raw.pointsinteger是-积分
raw.walletBalancestring是-钱包余额
card_address.citystring是-城市
card_address.countrystring是-国家
card_address.line1string是-地址行1
card_address.line2string是-地址行2
card_address.postCodestring是-邮编
card_address.statestring是-州/省

请求参数

Query 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location 'https://uat.bkj.com/openapi/v1/card/list?account_id=b8a77a39-a2dd-4799-99ca-936f1e63d44f%3A&currency=USD&status=actice&type=virtual&first_name=John&last_name=Mock-Doe' \
--header 'X-Api-Key: your-X-Api-Key' \
--header 'X-Timestamp: 1770356156' \
--header 'X-Signature: xxxxxxxx' \
--header 'X-Nonce: xxxxxxx' \
--header 'Accept-Language: en-US' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0,
    "data": {
        "page": 1,
        "take": 2,
        "total": 18,
        "list": [
            {
                "id": "09997081-1403-44b1-a7f3-fbf3d1340a1d",
                "created_at": "2026-01-14 10:00:00",
                "update_at": "2026-04-08 03:30:01",
                "remarks": null,
                "id_no": 2011377754139471874,
                "account_id": "039d4cec-d381-4b44-ba31-a75f56e1edd6",
                "label": "",
                "currency": "USD",
                "last4": "4529",
                "first8": "438214",
                "status": "active",
                "velocity_limit_window": "na",
                "velocity_amount_limit": "0",
                "type": "virtual",
                "channel_balance": "0",
                "raw": {
                    "association": "VISA",
                    "balanceCurrency": "SGD",
                    "billingCurrency": "SGD",
                    "caBalance": "0",
                    "cardBalance": "0",
                    "cardEmbossingName": "",
                    "cardHolder": "****AZBK",
                    "cardImage": "https://static.thedecard.com/images/card/face/visa/visa-card-normal-physical-front.png",
                    "cardNo": "************4529",
                    "cardStatus": "NORMAL",
                    "cardType": "NORMAL",
                    "physicalCardStatus": "UN_APPLY",
                    "points": 0,
                    "walletBalance": "0"
                },
                "first_name": "John",
                "last_name": "Mock-Doe",
                "card_address": {
                    "city": "Austin",
                    "country": "US",
                    "line1": "3415 Greystone Drive",
                    "line2": "Suite 205",
                    "postCode": "78731",
                    "state": "TX"
                },
                "physical_status": null
            },
            {
                "id": "bbedf315-38a0-408e-9f09-f9d70e0eeb52",
                "created_at": "2025-12-12 03:18:21",
                "update_at": "2026-04-08 03:30:01",
                "remarks": null,
                "id_no": 1999317871144157186,
                "account_id": "efdae7eb-4975-40cb-9e67-c22c2a285ac4",
                "label": "",
                "currency": "USD",
                "last4": "4263",
                "first8": "438214",
                "status": "active",
                "velocity_limit_window": "na",
                "velocity_amount_limit": "0",
                "type": "virtual",
                "channel_balance": "1670.6",
                "raw": {
                    "association": "VISA",
                    "caBalance": "0",
                    "cardBalance": "0",
                    "cardEmbossingName": "",
                    "cardHolder": "****CBBY",
                    "cardImage": "https://static.thedecard.com/images/card/face/visa/visa-card-normal-physical-front.png",
                    "cardNo": "************4263",
                    "cardStatus": "NORMAL",
                    "cardType": "NORMAL",
                    "physicalCardStatus": "UN_APPLY",
                    "points": 0,
                    "walletBalance": "0"
                },
                "first_name": "John",
                "last_name": "Mock-Doe",
                "card_address": {
                    "city": "Austin",
                    "country": "US",
                    "line1": "3415 Greystone Drive",
                    "line2": "Suite 205",
                    "postCode": "78731",
                    "state": "TX"
                },
                "physical_status": null
            }
        ]
    },
    "message": "success",
    "timestamp": 1775619050518
}
修改于 2026-04-17 08:40:24
上一页
激活实体卡
下一页
卡详情
Built with