2.1.39 Card Application (Billing mode)

Path:/openapi/card/apply/billing

Method:POST

Content-Type:application/json

Response Content-Type:application/json

Description:

If Retrive merchant card list interface response apply_type column equals 4, Then you must use this interface to apply the card

Example Request:

{
  "base_info": {
    "card_type_id": "40000002",
    "email": "example@gmail.com",
    "first_name": "pan",
    "first_recharge_amount": "188",
    "last_name": "gao",
    "mobile": "1888888888",
    "mobile_code": "86",
    "user_ip": "40.77.166.66"
  },
  "kyc_info": {
    "address": "maizidianjie28hao",
    "back_doc": "",
    "birthday": "1990-01-01",
    "city": "beijing",
    "country_id": 1,
    "doc_expire_date": "2026-06-16",
    "doc_never_expire": 0,
    "doc_no": 12345678,
    "doc_type": 1,
    "emergency_contact": "John",
    "front_doc": "",
    "gender": 1,
    "mix_doc": "",
    "nationality_id": 1,
    "sign_img": "",
    "state": "beijing",
    "zip_code": "100100",
    "poa_doc": "",
    "poa_type": "1"
  },
  "mc_trade_no": "48d2741747a4493223feb22"
}

Request Parameter:

note: The field limits of this interface will vary from card to card, you need to judge the field requirements of different cards according to the billing_kyc_column_limit field of interface Retrive merchant card list

If the fields in the following table's Required column are identified by true and false, they are processed according to the original logic. If a numeric identifier is used, it is processed according to the billing_kyc_column_limit field of interface Retrive merchant card list

For example:

if billing_kyc_column_limit field of interface Retrive merchant card list equal to 1, then the following column equal to 1 field is required;

If billing_kyc_column_limit field of interface Retrive merchant card list equal to 2, the field equal to 1 in the following column is not required

Parameter Name	Type	Required	Description
mc_trade_no	string	true	Transaction number, merchant defined; Maximum 64 characters.
base_info	object	true	User Base Info
card_type_id	string	true	Card type ID
email	string	true	Email；Maximum 64 characters.
first_name	string	true	First name；Maximum 50 characters
last_name	string	true	Last name；Maximum 50 characters
mobile	string	true	Mobile no；Minimum 6 characters and Maximum 11 characters
mobile_code	string	true	Mobile no country code；Maximum 5 characters
user_ip	string	false	User IP Address
first_recharge_amount	string	false	Initial deposit amount：Fiat amount deposited to the card after card application success, must be larger than 0. If pre_apply=true, can leave this filed as empty.
kyc_info	object	true	User KYC Info
birthday	string	true	Date of birth, format: yyyy-MM-dd
city	string	true	City；Maximum 100 characters
country_id	string	true	Country ID，Refer to the appendix【3.2 Mobile Phone Area Code and Country Code】-【ISO 3166 alpha2】for the range of values;If Retrive merchant card list response `kyc_country_limit_short` column is not empty, Then the value of this field must be within the`kyc_country_limit_short` field range
state	string	true	State；Maximum 100 characters; If Country corresponding province information has the province information corresponding to the passed `country_id` field, so the value of this field must be in the configured province range
address	string	true	Mailing address，Card will sending to this address；Maximum 256 characters; By default, the regular expression must be met:323_address_regex's Default regex . If card_type_id is in the range [71000003,71000002], the regular expression must be met: 323_address_regex's 71000003,71000002 regex
back_doc	string	false	Photo of back document；Encoded into bas64 format. The size of this field should be less than 2MB. Support：jpg,jpeg,png
doc_no	string	1	Document no；Maximum 128 characters
doc_type	integer	1	Document type；1 Passport 2 Identity no (Currently we only support Passport)
emergency_contact	string	1	Emergency contact person；Maximum 255 characters
front_doc	string	1	Photo of front document；Encoded into base64 format. The size of this field should be less than 2MB. Support：jpg,jpeg,png
gender	integer	1	Gender:1 Male; 2 Female
mix_doc	string	1	Photo of user with holding the ID/Passport；Encoded into base64 format. The size of this field should be less than 2MB. Support：jpg,jpeg,png
nationality_id	string	1	Nationality ID，Refer to the appendix【3.2 Mobile Phone Area Code and Country Code】-【ISO 3166 alpha2】for the range of values
sign_img	string	1	Photo of signature；Encoded into base64 format. The size of this field should be less than 1 MB. Support：jpg,jpeg,png
zip_code	string	1	Postal Code；Maximum 20 characters Same set as mobile no country code
doc_expire_date	string	false	Expiry date of Document；Maximum 16 characters; format: yyyy-MM-dd)
doc_never_expire	integer	1	Is the Document permanent; 1 is permanent，and then ignore the doc_expire_date filed; 0 is not permanent，and then the doc_expire_date filed must not Empty
poa_doc	string	false	Proof of address doc；Encoded into base64 format. The size of this field should be less than 2MB. Support：jpg,jpeg,png,pdf；If the 2.1.37 Retrive merchant card list-v5 api `need_poa` is 1, you can use this field supply poa doc
poa_type	integer	false	Proof of address type；1 Self-service provision 2 Assist with certification；If this value is 1, the poa_doc must not empty；If the 2.1.37 Retrive merchant card list-v5 api `need_poa` is 1, this field can not empty

API Response:

Parameter Name	Type	Description
code	string	Error code
msg	string	Error message

Example Response:

{
  "code": "00000",
  "msg": "ok"
}

2.1.39 Card Application (Billing mode)

2.1.39 Card Application (Billing mode)

results matching ""

No results matching ""