1. 持卡人
  • 接入指引
  • 异步回调
  • 文件上传
  • 认证
    • 获取令牌
      POST
  • 商户入网
    • 创建商户
      POST
    • 更新商户
      POST
    • 商户查询
      GET
  • 收款账户
    • 申请收款账户
      POST
    • 查询申请状态
      GET
    • 账户注销
      POST
    • 查询账户信息
      GET
    • 查询账户余额
      GET
    • 入账记录批量查询
      POST
    • 入账补充资料
      POST
  • 转账
    • 创建内部转账
      POST
    • 单笔转账查询
      GET
    • 转账流水分页查询
      POST
  • 付款
    • 创建付款订单
      POST
    • 单笔付款查询
      GET
    • 付款流水分页查询
      POST
  • 虚拟卡
    • 卡钱包
      • 开通卡钱包
      • 创建充值订单
      • 创建提现订单
      • 修改卡钱包状态
      • 查询卡钱包信息
      • 查询卡钱包流水
      • 获取可用的卡BIN码列表
      • 获取充值-收款账号/提现渠道
    • 卡片
      • 开卡申请
      • 卡片提额
      • 卡片降额
      • 查询卡片详细信息
      • 查询卡片手续费订单记录
      • 查询卡片支付订单详情
      • 分页查询卡片支付订单记录
      • 卡片冻结/解冻/注销
    • 持卡人
      • 创建持卡人
        POST
  • 异步回调
    • 商户
      • 商户审核回调通知
    • 收款账户
      • 账户申请结果通知
      • 账户注销/信息变更通知
      • 账户入账通知
    • 付款
      • 付款成功通知
      • 付款失败通知
      • 退款通知
    • 卡片
      • 卡片授权订单相关
      • 卡片注销、冻结,解冻
    • 卡钱包
      • 卡钱包审核回调
      • 卡钱包充值回调
      • 卡钱包提现回调
  1. 持卡人

创建持卡人

POST
/api/rest/v1/virtual-card/card/holder/create
接口描述:创建持卡人信息。

请求参数

Header 参数

Body 参数application/json

示例
{
    "merchantId": "string",
    "firstName": "string",
    "lastName": "string",
    "birthday": "string",
    "gender": "string",
    "country": "string",
    "idType": "string",
    "idNumber": "string",
    "phoneAreaCode": "string",
    "phone": "string",
    "email": "user@example.com",
    "province": "string",
    "city": "string",
    "address": "string",
    "postalCode": "string",
    "remarks": "string"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '/api/rest/v1/virtual-card/card/holder/create' \
--header 'Authorization: Bearer {{access_token}}' \
--header 'X-Signature: {{reqest_sign}}' \
--header 'X-Timestamp: {{$date.millisecondsTimestamp}}' \
--header 'X-Nonce: {{$helpers.rangeToNumber(min=10000000000,max=99999999999)}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "merchantId": "string",
    "firstName": "string",
    "lastName": "string",
    "birthday": "string",
    "gender": "string",
    "country": "string",
    "idType": "string",
    "idNumber": "string",
    "phoneAreaCode": "string",
    "phone": "string",
    "email": "user@example.com",
    "province": "string",
    "city": "string",
    "address": "string",
    "postalCode": "string",
    "remarks": "string"
}'

返回响应

🟢200
application/json
Bodyapplication/json

示例
{
  "success": false,
  "code": "",
  "message": "",
  "data": {
    "id": "",
    "merchantId": "",
    "firstName": "",
    "lastName": "",
    "birthday": "",
    "gender": "",
    "country": "",
    "idType": "",
    "idNumber": "",
    "phoneAreaCode": "",
    "phone": "",
    "email": "",
    "province": "",
    "city": "",
    "address": "",
    "postalCode": "",
    "remarks": ""
  }
}
修改于 2026-04-29 03:24:33
上一页
卡片冻结/解冻/注销
下一页
异步回调
Built with