Appearance
征信上报
将合规的征信相关数据上报至京诚凭证系统，用于征信体系建设与数据共享。
所有接口均需在请求头中携带：Authorization: Basic {Base64(appId:密钥)}
1. 上报个人征信数据
上报个人借贷、履约等可纳入征信的数据。
请求说明
| 项目 | 说明 |
|---|---|
| 请求方式 | POST |
| 请求地址 | /api/credit/report/person |
| Content-Type | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| name | string | 是 | 姓名 |
| idType | string | 是 | 证件类型：ID_CARD |
| idNo | string | 是 | 证件号码 |
| dataType | string | 是 | 数据类型：LOAN / REPAYMENT / OVERDUE / SETTLEMENT |
| bizNo | string | 是 | 业务流水号（您系统内唯一） |
| bizTime | string | 是 | 业务发生时间，格式 yyyy-MM-dd HH:mm:ss |
| amount | string | 否 | 金额（元），保留两位小数 |
| term | string | 否 | 期数/期限描述 |
| status | string | 否 | 状态：NORMAL / OVERDUE / SETTLED |
| remark | string | 否 | 备注 |
请求示例
http
POST /api/credit/report/person HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}
{
"name": "张三",
"idType": "ID_CARD",
"idNo": "110101199001011234",
"dataType": "REPAYMENT",
"bizNo": "BR202402090001",
"bizTime": "2024-02-09 10:00:00",
"amount": "5000.00",
"term": "12期",
"status": "NORMAL",
"remark": "按期还款"
}响应参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| data.reportId | string | 上报记录唯一 ID |
| data.receiveTime | string | 系统接收时间 |
| msg | string | 提示信息 |
响应示例
json
{
"code": 0,
"data": {
"reportId": "RP202402090001",
"receiveTime": "2024-02-09 15:10:00"
},
"msg": "success"
}2. 上报企业征信数据
上报企业信贷、履约等可纳入征信的数据。
请求说明
| 项目 | 说明 |
|---|---|
| 请求方式 | POST |
| 请求地址 | /api/credit/report/enterprise |
| Content-Type | application/json |
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| enterpriseName | string | 是 | 企业名称 |
| creditCode | string | 是 | 统一社会信用代码 |
| dataType | string | 是 | 数据类型：LOAN / REPAYMENT / OVERDUE / GUARANTEE / SETTLEMENT |
| bizNo | string | 是 | 业务流水号（您系统内唯一） |
| bizTime | string | 是 | 业务发生时间，格式 yyyy-MM-dd HH:mm:ss |
| amount | string | 否 | 金额（元） |
| status | string | 否 | 状态：NORMAL / OVERDUE / SETTLED |
| remark | string | 否 | 备注 |
请求示例
http
POST /api/credit/report/enterprise HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Basic {Base64(appId:密钥)}
{
"enterpriseName": "某某科技有限公司",
"creditCode": "91110000XXXXXXXX",
"dataType": "REPAYMENT",
"bizNo": "BE202402090001",
"bizTime": "2024-02-09 10:30:00",
"amount": "100000.00",
"status": "NORMAL",
"remark": "贷款按期还款"
}响应示例
json
{
"code": 0,
"data": {
"reportId": "RE202402090001",
"receiveTime": "2024-02-09 15:12:00"
},
"msg": "success"
}3. 查询上报结果
根据业务流水号或上报 ID 查询上报是否成功及状态。
请求说明
| 项目 | 说明 |
|---|---|
| 请求方式 | GET |
| 请求地址 | /api/credit/report/result |
请求参数（Query）
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| reportId | string | 否 | 上报记录 ID（与 bizNo 二选一） |
| bizNo | string | 否 | 您提交的业务流水号 |
请求示例
http
GET /api/credit/report/result?bizNo=BR202402090001 HTTP/1.1
Host: api.example.com
Authorization: Basic {Base64(appId:密钥)}响应示例
json
{
"code": 0,
"data": {
"reportId": "RP202402090001",
"bizNo": "BR202402090001",
"status": "SUCCESS",
"receiveTime": "2024-02-09 15:10:00",
"processTime": "2024-02-09 15:10:05"
},
"msg": "success"
}上报状态说明
| status | 说明 |
|---|---|
| SUCCESS | 上报成功并已入库 |
| PENDING | 待处理 |
| FAIL | 上报失败（可查看 msg 或联系技术支持） |