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/getHolder

使用场景#

 编辑持卡人,持卡人状态”待审批“ 或 ”审批拒绝“ 时,可进行编辑。
请求参数#
Http Post Application/json
字段类型是否必传描述
customer_idlong是客户id
app_idlong是应用id
keystring是授权key
holder_idlong是持卡人 id
示例
{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id":1000001
}
响应内容#
字段类型是否必传描述
holder_idlong是持卡人 id
customer_idlong是客户 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是证件正面照 url
id_card_backstring否证件背面照 url
handwritten_signaturestring是手写签名照 url
statusint是状态
reject_reasonstring是拒绝原因
create_atdatetime是创建时间
示例
{
    "code": 0,
    "message": "success",
    "data": {
        "holder_id": 1000001,
        "customer_id": 10000011,
        "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-28",
        "marital_status": 1,
        "nationality": "CN",
        "contact_area": "+86",
        "contact_no": "13722338876",
        "email": "xxx@xxx.com",
        "address": "address......",
        "province": "广东省",
        "city": "深圳市",
        "country": "CN",
        "post_code": "518000",
        "id_card_type": 1,
        "id_card_no": "440304199010282934",
        "id_card_front": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/cardHolderIdCardFront_383c88505df44903b27aa25398761ba1.png",
        "id_card_back": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/cardHolderIdCardBack_cf15f0e3f9d745fe9fbfd1d101c6db66.png",
        "handwritten_signature": "http://34.92.44.10:8000/storage/customer/customerFile?o=/cardHolder/10000011/HandwrittenSignature_13b552ae1548490bb6841f96b335cef6.png",
        "status": 2,
        "reject_reason": "",
        "create_at": "2023-10-24 06:16:39"
    }
}

请求参数

Body 参数application/json

示例
{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id": 1000001
}

请求示例代码

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/getHolder' \
--header 'Content-Type: application/json' \
--data-raw '{
    "customer_id": 10000011,
    "app_id": 100001,
    "key": "ae9ae3f5ad284ef4836de18aa3d41c47",
    "holder_id": 1000001
}'

返回响应

🟢200成功
application/json
Body

示例
{}
修改于 2026-03-19 06:16:48
上一页
编辑持卡人
下一页
删除持卡人
Built with