Mono Connect 与 DirectPay API v2 升级指南：开发者集成与迁移实操

我们很高兴宣布 Mono Connect 和 DirectPay API 的最新更新。这些更新与几周前发布的 Mono Connect 小部件 v2 的主要改进相辅相成，不仅简化了集成过程，还为开发人员和企业提供了更加无缝的体验。

Mono Connect API 的新增功能

客户端点

我们推出了全新的客户端点，帮助企业高效创建和管理客户实体。该 API 提供以下功能：

创建客户档案
检索客户详细信息
管理客户账户和交易

在 Customers 端点中，客户对象/ID 是调用 Connect（财务数据）和 DirectPay（支付）V2 端点的关键组件。这种设计实现了 Mono 产品之间的无缝集成。有关更多详细信息，请参阅 API 文档。

启动账户链接端点

通过启动账户链接端点，您可以生成一个可共享的 URL，用户无需设置 SDK 即可完成账户链接或重新授权银行账户的过程。这项功能极大地简化了账户链接的操作流程，使用户能够轻松连接其财务账户。

主要优势：

无需设置 SDK
简化业务集成流程

我们在 API 文档中提供了详细的集成指南，帮助您快速上手。

Mono DirectPay API 的新增功能

付款发起客户要求

“发起付款”端点现要求在请求有效载荷中包含客户对象。该对象需要以下字段之一：

客户 ID（ID）
客户姓名（name）和电子邮件地址（email）

货币操作 API

我们新增了一组货币操作端点，帮助企业和开发人员更高效地管理支付和退款操作。具体端点包括：

支付端点：获取按状态分类的所有支付详细信息，例如“待处理”、“低于限额”、“正在处理”、“已结算”或“失败”。
支付交易端点：通过 accountId 和 payoutId 检索所有支付交易的状态。
退款付款端点：使用付款参考 ID（reference）发起退款操作。

更多详细信息请参阅 Money Operations API 文档。

Mono Connect 和 DirectPay API v2 的更新

URL 端点版本更新

所有 Mono Connect 和 DirectPay 的 URL 端点已从 /v1/ 更新为 /v2/，例如：https://api.withmono.com/v2。这一更新不仅增强了功能，还确保了与最新版本小部件的兼容性。

数据格式更改

新版本对数据格式和结构进行了优化，提升了兼容性和信息的组织性。此外，每个响应中新增了“时间戳”字段，便于开发人员进行调试和故障排查。

企业和开发人员的主要收益

这些 API 的升级为开发人员和企业带来了以下好处：

性能改进：响应速度更快，延迟更低，系统更具可扩展性。
集成效率提升：优化的集成流程加快了实施速度，缩短了上线时间。
用户体验改善：无缝的开发者体验和更流畅的用户操作。

如何升级到 Mono Connect 和 DirectPay v2 API

为了顺利过渡到最新的 Mono v2 API，请按照以下步骤操作：

审查文档和发行说明

仔细阅读更新的 API 文档和发行说明，全面了解新功能和对现有集成的潜在影响。
评估兼容性

检查当前集成是否与 v2 API 兼容，并确定需要调整的地方。
制定升级计划

列出需要更新的端点，例如将 URL 更新为 /v2，并修改请求和响应的有效载荷。
更新端点调用

根据文档更新代码，确保端点 URL、请求有效载荷和响应处理逻辑符合最新规范。
测试和部署

对新集成进行全面测试，规划上线时间，并及时收集用户反馈。

常见问题解答

以前创建的应用程序是否仍然可以使用升级后的 API？

是的，之前创建的应用程序仍然可以使用新 API。我们确保了向后兼容性，您可以无缝过渡到新版 API。

旧版本 API 的支持期限是多久？

Mono Connect 和 DirectPay API 以及小部件的 v1 版本将支持到 2024 年 5 月 31 日。在此日期之后，所有 API 和小部件都需要更新到 v2 版本。

总结

Mono Connect 和 DirectPay API v2 的发布为开发人员和企业提供了更强大的功能、更高的性能和更便捷的集成体验。通过升级到最新版本，您将能够充分利用这些改进，为用户提供更优质的服务。

原文链接: https://mono.co/blog/introducing-mono-apis-v2