2.1.3 授信(必选)

流量提供方推送进件信息给流量承接方

接口提供方: 流量承接方(KN)
接口调用方: 流量提供方
method: credit_granting

请求参数

参数	类型	必选	说明	备注
phone	string	N	手机号	手机号为10位; 首次授信必传; 后续授信不用传
receiver_user_id	string	N	`流量承接方`的用户id	不超过32位; 首次授信不传; 后续授信`receiver_user_id`& `provider_user_id` 传其中一个即可
provider_user_id	string	N	`流量提供方`的用户id	不超过32位; 首次授信不传; 后续授信`receiver_user_id`& `provider_user_id` 传其中一个即可
provider_credit_id	string	N	`流量提供方`的授信id	不超过32位; 不必传; 后续查询可采用`response`的`receiver_credit_id`
individual_info	object	N	用户信息	首次授信必传
device_info	object	Y	设备信息	-
extend_info	object	Y	扩展信息	-
ip	string	N	ip	用户发起授信时请求头里面的`ip`

individual_info

参数	类型	必选	说明	备注
id_card_info	object	Y	身份证件信息	-
living_info	object	Y	活体认证信息	-
bank_card_info	object	Y	银行卡信息	-
contact_info	object	Y	联系人信息 -
personal_info	object	Y	个人信息	-

individual_info.id_card_info

参数	类型	必选	说明	备注
id_number	string	Y	身份证id	-
gender_id	int	Y	性别id	见 3.1.1
date_of_birth	string	Y	生日	格式：2006-01-02
full_name_th	string	Y	全名(泰文)	-
id_card_front_image_url	string	Y	身份证件正面照片url	-
exif	string	N	图片exif信息	将`json`序列化成字符串后传过来;`json`结构见 3.2.2

individual_info.living_info

参数	类型	必选	说明	备注
living_image_url	string	Y	活体照片url	-

individual_info.bank_card_info

参数	类型	必选	说明	备注
list	array object	Y	银行卡列表	至少保证有一张银行卡

individual_info.bank_card_info.list.object

参数	类型	必选	说明	备注
bank_code	string	Y	银行编码	通过 2.3.4 接口获取
bank_card_number	string	Y	银行卡卡号	-

individual_info.contact_info

参数	类型	必选	说明	备注
list	array object	Y	联系人列表	-

individual_info.contact_info.list.object

参数	类型	必选	说明	备注
name	string	Y	联系人姓名	-
phone	string	Y	联系人手机号	-
relationship_id	int	Y	人物关系id	见 3.1.2

individual_info.personal_info

参数	类型	必选	说明	备注
email	string	Y	电子邮箱
salary_range_id	int	Y	收入范围id	见 3.1.3
children_number_id	int	Y	孩子数量id	见 3.1.4
education_id	int	Y	受教育程度id	见 3.1.5
phone_duration_id	int	Y	手机使用时长id	见 3.1.6
sim_duration_id	int	Y	sim卡使用时长id	见 3.1.7

device_info

参数	类型	必选	说明	备注
lon	string	N	经度	-
lat	string	N	纬度	-
device_info_url	string	Y	数据采集文件的url	见 3.2.1

extend_info

参数	类型	必选	说明	备注
feature_list	array object	N	特征列表	-

extend_info.feature_list.object

参数	类型	必选	说明	备注
key	string	N	键	-
value	string	N	值	-

响应参数

参数	类型	必选	说明	备注
status	int	Y	业务状态码	见 3.3.2
reject_reason	string	Y	拒绝原因	非成功时必传
receiver_user_id	string	N	`流量承接方`的用户id	不超过32位; 成功时必传
receiver_credit_id	string	N	`流量承接方`的授信id	不超过32位; 成功时必传; 此字段可用于后续的授信结果通知和查询

请求参数示例

情况一：首次授信

json

{
    "phone": "0612345678",
    "provider_user_id": "12345678",
    "provider_credit_id": "2020010119190202",
    "individual_info": {
        "id_card_info": {
            "id_number": "1209000091019",
            "gender_id": 1,
            "date_of_birth": "2005-01-02",
            "full_name_th": "นาย วันชัย บุญเดช",
            "id_card_front_image_url": "https://abc.com/def",
            "exif": "{\"w\":\"4000\",\"h\":\"3000\",\"bpp\":\"24\",\"compt\":\"JPEG\",\"cs\":\"sRGB\",\"r\":\"0\",\"cpp\":\"3\",\"dpi\":\"300×300\",\"ru\":\"dpi\",\"mfr\":\"Canon\",\"m\":\"EOS R5\",\"fv\":\"v1.3.2\",\"sn\":\"ABC12345678\",\"li\":\"RF 24-70mm F2.8 L IS USM\",\"lsn\":\"LN987654\",\"capt\":\"2024-10-27 09:45:12\",\"et\":\"1/500s\",\"at\":\"2.8\",\"iso\":\"100\",\"fl\":\"24.0mm\",\"fl35\":\"24mm\",\"ep\":\"程序自动\",\"mm\":\"评价测光\",\"fs\":\"未闪光\",\"wb\":\"自动\",\"ec\":\" 0.3\"}"
        },
        "living_info": {
            "living_image_url": "https://abc.com/def"
        },
        "bank_card_info": {
            "list": [
                {
                    "bank_code": "T00013",
                    "bank_card_number": "8191234567"
                }
            ]
        },
        "contact_info": {
            "list": [
                {
                    "name": "นายฐาปณัฐคุ้มเจ",
                    "phone": "0612345678",
                    "relationship_id": 1
                }
            ]
        },
        "personal_info": {
            "email": "123@abc.com",
            "salary_range_id": 1,
            "children_number_id": 1,
            "education_id": 1,
            "phone_duration_id": 1,
            "sim_duration_id": 1
        }
    },
    "device_info": {
        "lon": "103.2521260462915",
        "lat": "16.234234234234233",
        "device_info_url": "https://abc.com/def"
    },
    "extend_info": {
        "feature_list": [
            {
                "key": "feature_a",
                "value": "feature_a_value"
            },
            {
                "key": "feature_b",
                "value": "1"
            }
        ]
    },
    "ip": "1.2.3.4"
}

情况二：后续授信

json

{
    "receiver_user_id": "87654321",
    "provider_credit_id": "2020010119190202",
    "device_info": {
        "lon": "103.2521260462915",
        "lat": "16.234234234234233",
        "device_info_url": "https://abc.com/def"
    },
    "ip": "1.2.3.4"
}

响应参数示例

json

{
    "code": 0,
    "message": "success",
    "data": {
        "status": 110000,
        "remark": "",
        "receiver_user_id": "87654321",
        "receiver_credit_id": "2020036532193609"
    }
}

2.1.3 授信(必选) ​

2.1.3 授信(必选)