Token Payment
Token Payment

Bind Card Holder

According to Card Bin Info The needKyc field determines whether it is necessary to KYC.

KYC Created through interfaces related to the cardholder.

This interface is used to bind the cardholder's information to the card, and it can also be used to fill in mailing address information.

Request method: PATCH

Request Path: /v2/card/holder

Request Body: application/json

Field Name Description Example Required
cardId Card ID 1 yes
holderId Card holder ID 10 yes
postcode Postal code 10 yes
country Country 10 yes
phone Telephone address 10 yes
address Detailed address 10 yes
userName Name 10 yes
nationCode Dialling code 10 yes
Example
{
    "cardId": "91456986464987",
    "holderId": 4,
    "postcode": "4923",
    "country": "United States",
    "state": "California",
    "city": "Los Angeles",
    "street": "1060  Grove Street",
    "address": "1234 Sunset Strip, Los Angeles, CA 90028"
}
```Request Method

### Reponse Data
```json title="Reponse example"
{
    "code": 200,
    "message": "Success",
    "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": "United States",
        "cardSingleLimit": 10000,
        "cardMonthLimit": 20000,
        "cardTotalLimit": 100000,
        "totalOpenCardNum": 50,
        "platformRechargeFeeRate": 0.02,
        "businessRechargeFeeRate": 0.02
    }
}