通证支付
通证支付
简体中文

绑定用卡人

根据卡段详情 中的 needKyc 字段判断是否需要进行 KYC。

KYC 通过持卡人相关接口进行创建。

该接口用于绑定用卡人信息到卡片上, 同时可以填写邮寄地址等信息。

请求方法: PATCH

请求路径: /v2/card/holder

请求参数：application/json

字段名 字段描述 示例值 是否必须
cardId 卡片 ID 1 必须
holderId 用卡人 ID 10 必须
postcode 邮编 10 必须
country 国家 10 必须
phone 电话地址 10 必须
address 详细地址 10 必须
userName 用户 10 必须
nationCode 区号 10 必须
数据示例
{
    "cardId": "91456986464987",
    "holderId": 4,
    "postcode": "4923",
    "country": "中国",
    "state": "云南省",
    "city": "鄂尔多斯市",
    "street": "清河区xx街道xx小区几零几",
    "address": "云南省鄂尔多斯市清河区xx街道xx小区几零几"
}

响应数据

响应示例
{
    "code": 200,
    "message": "操作成功",
    "data": {
        "cardMonthFee": 0.1,
        "cardImg": "/2024-08-02/BiKPRGryCqZt.png",
        "cardModel": "share",
        "cardManageId": 20,
        "cardBin": "5347",
        "isAble": true,
        "alreadyOpenedCardNum": 0,
        "platformOpenCardFee": 2,
        "platformCancelCardFee": 1,
        "businessOpenCardFee": 2,
        "businessCancelCardFee": 1,
        "firstRecharge": 0,
        "cardScheme": "Master",
        "cardScene": [
            "FaceBook",
            "Google",
            "Amazon",
            "PayPal",
            "Shopify",
            "Tiktok",
            "Alibaba",
            "AliExpress"
        ],
        "cardCountry": "美国",
        "cardSingleLimit": 10000,
        "cardMonthLimit": 20000,
        "cardTotalLimit": 100000,
        "totalOpenCardNum": 50,
        "platformRechargeFeeRate": 0.02,
        "businessRechargeFeeRate": 0.02
    }
}