1. Holder
OPEN-API
  • API Call Description
  • Constant Declaration
    • Wallet
      • Wallet Status
      • In Out Type
      • Transaction Type
      • Transaction Status
    • Bin
      • Bin Type
      • Bin Mode
      • Bin Status
    • Card
      • Card Status
      • Card Trade
        • Card Trade Type
        • Card Trade Result
    • Order
      • Card Type
      • Order Type
      • Order Status
      • Order Bill
        • Order Bill Type
        • In Out Type
        • Bill Category
    • Payee
      • Payee Status
    • Payment
      • Fee Mode
      • Payment Status
  • Webhook
    • Card Notify
      • Order
      • Card
      • Card Trade
    • Payee Notify
    • Payment Notify
    • Wallet Notify
  • Api
    • Wallet
      • 钱包列表
      • 钱包详情
      • 交易流水列表
      • 交易详情
      • 获取兑换汇率
    • Card
      • Bin
        • 卡Bin列表
        • 卡Bin详情
        • 卡Bin费用
        • 卡Bin限制
      • Card
        • 卡列表
        • 卡详情
        • 卡激活
        • 卡冻结
        • 卡解冻
        • 发起销卡
        • 卡交易列表
        • 商户交易评分
      • Order
        • 开卡
        • 卡充值
        • 订单列表
        • 订单详情
      • Holder
        • 持卡人列表
          POST
        • 创建持卡人
          POST
        • 编辑持卡人
          POST
        • 持卡人详情
          POST
        • 删除持卡人
          POST
    • PayMethod
      • 付款方式
    • Payee
      • 运营资金来源列表
      • 预期付款目的列表
      • 创建收款方
      • 编辑收款方
      • 申请收款方
      • 删除收款方
      • 收款方列表
      • 收款方详情
    • Payment
      • 付款原因
      • 创建付款
      • 付款列表
      • 付款详情
  1. Holder

编辑持卡人

POST
/{{version}}/openApi/holder/editHolder

使用场景#

 编辑持卡人。
请求参数#
Http Post Application/json
字段类型是否必传描述
customer_idlong是客户id
app_idlong是应用id
keystring是授权key
holder_idstring是持卡人 id
first_namestring否中文 名
last_namestring否中文 姓
first_name_enstring是英文 名
last_name_enstring是英文 姓
genderint否性别 1:男 2:女
birthdaydate否出生日期
marital_statusint否婚姻状态 1:已婚; 2:未婚
nationalitystring否国籍, 如 USA
contact_areastring是联系号码区号
contact_nostring是联系号码
emailstring是邮箱
addressstring是地址
provincestring是州/省
citystring是城市
countrystring是国家
post_codestring是邮编
id_card_typeint否证件类型
id_card_nostring否证件号
id_card_frontstring否证件正面照 base64编码
id_card_front_suffixstring否证件正面照 文件后缀,如png,jpg等
id_card_backstring否证件背面照 base64编码,如果是中华人民共和国身份证,需要上传背面
id_card_back_suffixstring否证件背面照 文件后缀,如png,jpg等,如果是中华人民共和国身份证,需要上传背面
handwritten_signaturestring否手写签名照 base64编码
handwritten_signature_suffixstring否手写签名照 文件后缀,如png,jpg等
示例
{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id": "hid_dcfwwklwehf235",
    "first_name": "first_name",
    "last_name": "last_name",
    "first_name_en": "first_name_en",
    "last_name_en": "last_name_en",
    "gender":1,
    "birthday":"1990-10-29",
    "marital_status": 1,
    "nationality": "CN",
    "contact_area": "+86",
    "contact_no": "13722338874",
    "email": "xxx@xxx.com",
    "address": "address......",
    "province": "广东省",
    "city": "深圳市",
    "country": "CN",
    "post_code": "518000",
    "id_card_type": 1,
    "id_card_no": "110001199208123412",
    "id_card_front": "base64 data",
    "id_card_front_suffix": "png",
    "id_card_back": "base64 data",
    "id_card_back_suffix": "png",
    "handwritten_signature": "base64 data",
    "handwritten_signature_suffix": "png"
}
响应内容#
字段类型是否必传描述
示例
{
    "code": 0,
    "message": "success"
}

请求参数

Body 参数application/json

示例
{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id": "hid_dcfwwklwehf235",
    "first_name": "first_name",
    "last_name": "last_name",
    "first_name_en": "first_name_en",
    "last_name_en": "last_name_en",
    "gender":1,
    "birthday":"1990-10-29",
    "marital_status": 1,
    "nationality": "CN",
    "contact_area": "+86",
    "contact_no": "13722338874",
    "address": "address......",
    "province": "广东省",
    "city": "深圳市",
    "country": "CN",
    "post_code": "518000",
    "id_card_type": 1,
    "id_card_no": "110001199208123412",
    "id_card_front": "base64 data",
    "id_card_front_suffix": "png",
    "id_card_back": "base64 data",
    "id_card_back_suffix": "png",
    "handwritten_signature": "base64 data",
    "handwritten_signature_suffix": "png"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'http://prod-cn.your-api-server.com/{{version}}/openApi/holder/editHolder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id": "hid_dcfwwklwehf235",
    "first_name": "first_name",
    "last_name": "last_name",
    "first_name_en": "first_name_en",
    "last_name_en": "last_name_en",
    "gender":1,
    "birthday":"1990-10-29",
    "marital_status": 1,
    "nationality": "CN",
    "contact_area": "+86",
    "contact_no": "13722338874",
    "address": "address......",
    "province": "广东省",
    "city": "深圳市",
    "country": "CN",
    "post_code": "518000",
    "id_card_type": 1,
    "id_card_no": "110001199208123412",
    "id_card_front": "base64 data",
    "id_card_front_suffix": "png",
    "id_card_back": "base64 data",
    "id_card_back_suffix": "png",
    "handwritten_signature": "base64 data",
    "handwritten_signature_suffix": "png"
}'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2026-03-19 06:16:48
上一页
创建持卡人
下一页
持卡人详情
Built with