本产品主要用于KYC后的二要素核验。
API 方式
Base URL
API
URL | 请求方式 | Content-Type | 输出格式 | 字符集 |
---|---|---|---|---|
api-base-url?partner_code=xxx&partner_key=xxx | POST | application/json | JSON | UTF-8 |
认证参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
partner_code | String | 合作方标识 | 必须 | 由 TD 分配 |
partner_key | String | 合作方密钥 | 必须 | 由 TD 分配 |
请求参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
id_number | String | 身份证件 ID 号码 | 必须 | ID number,13位数字 |
id_type | String | 身份证件 ID 类型 | 必须 | 巴基斯坦-枚举值: CNIC / NIC |
phone_number | String | 手机号 / 电话号码 | 必须 | 样例:3XZYYYYYYY |
country | String | 国家 | 必须 | 国家,必填. 两位国家码,符合 ISO 3166 标准。目前支持:巴基斯坦(PK) |
请求示例
{
"country": "PK",
"phone_number": "3008419184",
"id_type": "CNIC",
"id_number": "4430207575177"
}
响应参数
字段 | 类型 | 含义 | 建议 | 备注 |
---|---|---|---|---|
code | Integer | API 状态码 | 必须 | |
message | String | 状态信息 | 必须 | 在 API 异常状态下会输出具体的异常原因 |
sequence_id | String | 响应唯一码 | 必须 | 用于跟踪每次请求记录的唯一标识 |
result | String | 核验结果 | 必须 | 枚举值: 通过:pass 不通过:fail 无纪录:no_record |
API状态码
code | Message | 含义 | 是否收费 |
---|---|---|---|
200 | success | 成功 | 是 |
300 | Service not purchased or not effective | 服务不可⽤ | 否 |
301 | Service not purchased | 服务未购买 | 否 |
302 | Service has been suspend | 服务已被禁⽤ | 否 |
303 | Not enough balance | 流量不足 | 否 |
304 | Service expired | 服务已过期 | 否 |
11350 | Internal error | 系统错误 | 否 |
11301 | {parameter} empty | {参数}为空 | 否 |
11304 | The country partner located is not open | 国家不支持 | 否 |
11340 | {parameter} error | {参数}错误 | 否 |
响应示例
- 业务成功示例
{
"code": 200,
"message": "Success",
"sequence_id": "1648777165770866F82AC7F326307055",
"result": "pass"
}
- 业务失败示例
{
"code": 11350,
"message": "Internal error",
"sequence_id": "170427842997****I3167369D6187177",
"result": "fail"
}