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

什么是 Mono Creditworthy API？

Mono Creditworthy API 是一款专为尼日利亚信贷企业设计的工具，旨在帮助企业安全评估用户的财务状况，判断其是否可能对业务造成贷款风险。通过分析用户的历史财务数据和现金流行为，该 API 可以有效评估用户的信用状况。

通过输入贷款本金、贷款利率、还款期限以及信用历史检查等数据点，企业可以判断借款人是否有能力负担贷款金额以及按时还款。Mono Creditworthy API 能够实时提供用户信用评估结果，从而缩短贷款审批时间，降低风险，并提高贷款偿还率。

Mono Creditworthy API 的工作原理

为了使用 Mono Creditworthy API 评估用户的信贷资格，企业需要在 API 请求中提供以下信息：

• 本金：初始贷款金额，例如 500 万奈拉。
• 利率：贷款金额的年利率，作为整数传递，例如 5 表示 5%。
• 期限：以月为单位的还款期限，例如 2 年的贷款期限传递为 24。
• 信用历史检查：决定是否将信用局提供的用户信用历史信息纳入评估。

用户需要通过 Mono Widget 连接其银行账户，完成后会生成一个唯一的账户 ID（account_id），用于调用 Creditworthy API。

API 会根据用户的交易信息与提供的本金、利率和期限进行计算，结合用户的财务数据评估其还款能力。如果启用了信用历史检查，API 还会整合信用局的信用历史数据进行更全面的评估。随后，API 会通过 Webhook 返回评估结果，包括用户是否有能力偿还贷款的布尔值、每月还款金额等详细信息。

如何在产品中集成 Mono Creditworthy API

要开始使用 Mono Creditworthy API，您需要完成以下步骤：

1. 创建 Mono 账户

   如果您尚未注册，请先创建一个 Mono 账户。

2. 提交业务文件并完成合规流程

   提交必要的业务文件以完成验证。

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

   在 Mono 仪表板上创建一个应用程序，并选择“连接”作为产品范围。

4. 获取应用程序密钥

   在 Mono 仪表板上生成应用程序密钥，用于调用 API。

5. 配置 Webhook URL

   在应用程序中添加 Webhook URL，以便在用户财务状况评估完成后接收通知。

请注意，调用任何 Mono API 端点时，必须在请求头中包含 Mono-sec 密钥。

1. 连接用户账户

评估用户信用的关键是获取用户的 account_id。用户需要先将其银行账户与 Mono 连接，您可以使用 Mono 提供的链接账户端点完成此操作。Mono 还提供适用于移动端的 SDK。

成功连接账户后，您可以通过 Webhook 响应获取 account_id。在进行进一步操作之前，请确保账户数据状态为“可用”。您可以通过查询账户详细信息 API 或处理账户更新 Webhook 来验证数据状态。

2. 调用 Mono Creditworthy API

要评估用户的信用，您需要向 API 端点发送请求，并在路径参数中传递 account_id 和应用程序密钥。同时，在请求正文中提供以下参数：

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

请确保 BVN 有效，否则 API 调用将失败。您可以使用 Mono 的 BVN 验证端点来检查 BVN 的有效性。

成功调用 API 后，您会收到一个 JSON 响应，表示请求已被处理，随后会通过 Webhook 发送包含详细数据的通知。

3. 集成 Webhook

为了接收用户财务状况和信用资格的评估结果，您需要在应用程序中配置 Webhook URL。Webhook 响应包含以下关键信息：

• event：事件类型，例如 mono.events.account_credit_worthy。
• month_assessed：评估的时间范围。
• summary.can_afford：布尔值，表示用户是否有能力偿还贷款。
• summary.monthly_payment：根据请求信息计算的每月还款金额。
• 债务信息：用户未偿还债务的详细信息，包括欠款总额及各机构的欠款明细。

请务必通过发送 200 OK 响应确认成功接收 Webhook 事件。

Webhook 响应示例

用户信誉良好（summary.can_afford: true）

当用户有能力偿还贷款时，summary.can_afford 字段返回 true，如下图所示：

用户信誉不佳（summary.can_afford: false）

当用户无力偿还贷款时，summary.can_afford 字段返回 false，并提供未偿还债务的详细信息：

使用 Mono Creditworthy API 的优势

Mono Creditworthy API 为贷款企业提供了一种安全、高效的信用评估方式，能够帮助企业：

• 缩短贷款审批时间
• 降低贷款风险
• 提高贷款偿还率

通过准确评估潜在借款人的信用额度和贷款资格，企业可以优化其承保流程，提升业务效率。

常见问题解答

使用 Mono Creditworthy API 的费用是多少？

• 当启用信用检查时，每次成功的 API 调用费用为 500 奈拉。
• 如果未启用信用检查，每次调用费用为 200 奈拉。

谁可以使用 Mono Creditworthy API？

任何在非洲运营的信贷业务都可以使用该 API 来评估用户的财务状况。但需要确保用户通过 Mono 将其账户连接到您的业务。

通过 Mono Creditworthy API，信贷企业可以更高效地评估用户的信用状况，从而降低风险并提升业务成功率。

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