Mono Creditworthy API 集成指南｜实时评估用户信用状况

一. 什么是 Mono Creditworthy API？

Mono Creditworthy API 是专为尼日利亚信贷企业设计的信用评估工具，旨在帮助企业：

• 安全评估用户财务状况
• 判断潜在贷款风险
• 实时获得信用评估结果

通过分析用户的历史财务数据和现金流行为，企业可以快速判断借款人是否具备按时还款能力，从而缩短审批时间并降低贷款违约风险。

二. Mono Creditworthy API 的工作原理

使用该 API 时，企业需要提供以下信息：

1. 主要参数

2. 用户账户连接

用户通过 Mono Widget 连接银行账户后，会生成一个唯一的 account_id，用于调用 Creditworthy API。

API 会结合用户交易数据及贷款信息进行计算，并通过 Webhook 返回评估结果，包括：

• 用户是否有能力偿还贷款（布尔值）
• 每月还款金额
• 未偿还债务明细（如有）

三. 产品集成步骤

1. 创建 Mono 账户

注册并完成企业验证流程。

2. 提交业务文件并完成合规审核

确保业务合法合规，满足使用 API 的要求。

3. 创建应用程序并选择产品范围

在 Mono 仪表板中选择“连接”产品。

4. 获取应用程序密钥

用于 API 调用的 Mono-sec 密钥。

5. 配置 Webhook URL

接收用户信用评估结果的实时通知。

四. 关键操作

1. 连接用户账户

a. 获取 account_id

用户需通过 Mono 连接银行账户。可使用 Mono 提供的链接账户端点或移动端 SDK。

b. 验证账户状态

确保账户状态为“可用”，可通过查询账户详细信息或 Webhook 更新验证。

2. 调用 Creditworthy API

a. 请求参数

向 API 端点发送请求，提供以下参数：

• 用户银行验证号（BVN）
• 本金、利率、期限
• 是否启用信用检查

注意：BVN 必须有效，可通过 BVN 验证端点 进行检查。

b. 响应处理

调用后会收到 JSON 响应，并通过 Webhook 接收完整评估结果。

3. 集成 Webhook

a. Webhook 关键字段

Webhook 响应包括：

• event：事件类型，如 mono.events.account_credit_worthy
• month_assessed：评估时间范围
• summary.can_afford：用户是否有还款能力
• summary.monthly_payment：每月还款金额
• 债务信息：用户未偿还债务明细

接收 Webhook 时需返回 200 OK 确认。

b. 响应示例

信用良好

summary.can_afford: true

信用不佳

summary.can_afford: false

五. Mono Creditworthy API 的优势

• 缩短贷款审批时间
• 降低贷款违约风险
• 提高贷款偿还率
• 优化承保流程，提高业务效率

六. 常见问题

1. 使用费用

• 启用信用检查：每次调用 500 奈拉
• 未启用信用检查：每次调用 200 奈拉

2. 使用范围

适用于在非洲运营的信贷企业，但用户必须通过 Mono 连接账户。

原文链接: https://mono.co/blog/introducing-mono-creditworthiness-api