api/对接接口文档.md

印尼支付行为画像查询接口

接口信息

项目	说明
接口路径	POST /api/v1/fortispay/payment-feature
请求格式	application/json; charset=UTF-8
响应格式	application/json

请求头部

参数	类型	必填	说明
Content-Type	String	Y	application/json
X-Request-Id	String	N	网关请求唯一标识ID，用于全链路追踪，原样回显在响应头中
X-Language	String	N	语言标识，传 en 返回英文结果，不传默认中文

响应头部

参数	类型	说明
X-Request-Id	String	回显请求头中的 X-Request-Id，未传则自动生成 32 位 UUID
X-Session-Id	String	三方服务返回的唯一会话标识（Fortispay responseId）

请求体

字段	类型	必填	说明
name	String	Y	用户姓名
idCard	String	Y	身份证号，支持明文或 MD5 密文
mobile	String	Y	手机号（带国家码），支持明文或 MD5 密文
encryptAlgo	String	N	加密算法。不传表示明文，服务端原样透传给三方；传入 MD5 表示已加密，直接透传

请求示例

{
  "name": "ABCXYZ",
  "idCard": "3201190108990002",
  "mobile": "6285887456612"
}

idCard、mobile 传明文时无需传 encryptAlgo，服务端原样透传给三方。

{
  "name": "ABCXYZ",
  "idCard": "cf0ab15098ab149e5273dd82f2c737e6",
  "mobile": "bd82af6340240c43175a80aedf7e6eef",
  "encryptAlgo": "MD5"
}

idCard、mobile 传密文时必须传 encryptAlgo="MD5"。

响应体

返回以下 6 个特征字段：

• app_behavior — 申请行为变量
• loan_behavior — 放款行为变量
• repay_behavior — 还款行为变量
• time_structure — 行为时间结构变量
• delinq_monitor — 逾期行为监控
• flow_anomaly — 资金流量异常监控变量

字段	类型	说明
code	String	响应码，"0" 表示成功，更多请查看富通接口规范.pdf 常见响应编码表
message	String	提示消息，如 "success"
status	Integer	查询状态，仅code为 "0" 时有值（1 = 查得，0 = 未查得）
responseId	String	三方响应的唯一标识ID
data	Object	结果数据（Map），仅code为 "0" 时不为null

成功响应示例

{
  "code": "0",
  "message": "success",
  "status": 1,
  "responseId": "0b5a09b6ea7d77dbbbb92e05dc9744ad",
  "data": {
    "app_behavior": { "..." : "..." },
    "loan_behavior": { "..." : "..." },
    "repay_behavior": { "..." : "..." },
    "time_structure": { "..." : "..." },
    "delinq_monitor": { "..." : "..." },
    "flow_anomaly": { "..." : "..." }
  }
}

未查得响应示例

{
  "code": "0",
  "message": "success",
  "status": 0,
  "responseId": "0b5a09b6ea7d77dbbbb92e05dc9744ad",
  "data": {
    "app_behavior": { "..." : null },
    "loan_behavior": { "..." : null },
    "repay_behavior": { "..." : null },
    "time_structure": { "..." : null },
    "delinq_monitor": { "..." : null },
    "flow_anomaly": { "..." : null }
  }
}

错误响应

统一错误格式：

{
  "error": "ERROR_CODE",
  "message": "错误描述",
  "timestamp": "2026-07-08T10:30:00Z"
}

HTTP状态码	error	说明
400	VALIDATION_ERROR	请求参数校验失败
502	HTTP_ERROR	三方 API HTTP 错误
503	NETWORK_ERROR	三方 API 网络不可达
500	INTERNAL_ERROR	服务内部未知异常 api配置信息未找到

完整调用示例

curl -X POST http://{host}:{port}/api/v1/fortispay/payment-feature \
  -H "Content-Type: application/json" \
  -H "X-Request-Id: 9c6ccc0f3ad3886dfe56ed364b6dc3e8" \
  -H "X-Language: en" \
  -d '{
    "name": "ABCXYZ",
    "idCard": "3201190108990002",
    "mobile": "6285887456612"
  }'