在银行账户姓名报价中区分转账本金、来源成本与服务费

先在免费沙盒中跑通流程,再准备生产接入。

统计选择在本站复用,可随时关闭;账号关联另行同意。

在银行账户姓名报价中区分转账本金、来源成本与服务费

墨西哥的付款团队希望针对一个 CLABE,把收款人姓名与银行证据进行核对。报价中可能包含一笔小额转账。如果你的账本把整个报价记成一笔费用,就无法区分哪部分是作为转账本金离开你账户的钱、哪部分是证据来源收取的成本、哪部分是服务费。本文提出应用如何把这些金额分开记录,如何解读合成合同示例,以及在信任任何结果之前应检查什么。该示例只是合成的合同说明,不是实时核查,也不代表实时验收。

gridzen tools --product mx-account-name

接入指南

问题与需要做出的决定

你的付款集成需要核对一个新收款人 CLABE 上的姓名。该产品针对一个获准查询的 CLABE,把预期收款人姓名与受支持的银行证据进行比对。输入包括 CLABE、预期收款人姓名、持有人类型、当前报价、授权引用以及稳定的请求 UUID。报价中可能包含小额转账。这一点很重要,因为小额转账会把钱转给某个收款人,它不只是服务收费。你要决定的是:是否接受报价;如果接受,如何记录,才能让财务、客服和审计看到三件不同的事:转给收款人的转账本金、为获取证据而产生的来源成本,以及服务费。把三者合并成一个数字,会掩盖谁收到了钱、为什么收到,以及这笔支出是否已针对该收款人获得授权。

产品合同的规定与应用自行设计的部分

已实现的合同(以文档为准):输出是任务状态以及附带证据和费用的姓名比对结果;相似度不确定时需要人工复核。小额转账需要明确的收款人授权和支出授权。该结果不是证件身份核验,也不能证明对方目前控制该账户。商户执行需要当前能力、授权以及已接受的报价。相关工具有 mexico_account_name_capabilities、quote_mexico_account_name、verify_mexico_account_name、get_mexico_account_name 和 recover_mexico_account_name。建议的应用设计由你自己实现:报价记录包含三条独立金额行(本金、来源成本、服务费),一个与 CLABE 绑定的收款人字段,一个支出授权引用,以及一条规则:任何金额行在缺少相应授权时都不得接受。产品不会替你生成这些账务行,本文也不声称报价有某种特定格式。

假设场景与预期的示例输出

假设:平台上的一位卖家要求把收款改到一个新的 CLABE,并提供了预期姓名。你的服务先查询能力,再申请报价。假设报价显示可能需要一笔小额转账。你的设计把它拆开:本金行把该 CLABE 持有人列为收款人;来源成本行和服务费行分别注明证据渠道和服务方。一位对该收款人拥有支出授权的操作员接受报价,然后使用同一个稳定请求 UUID 提交请求。合成合同示例的返回值是:status review、name_match inconclusive、verified false、automatic_business_approval false。请按字面理解:review 表示必须由人工查看;inconclusive 既不是不匹配也不是匹配;verified false 表示没有经过核实的结论;automatic_business_approval false 表示任何收款信息都不得自动更改。这个示例不会向任何真实服务商发出请求。

失败处理

如果能力列表中没有该任务,就不要申请报价。如果报价已过期或发生变化,应重新申请,而不是沿用旧的接受记录。如果出现小额转账,但没有指明收款人或缺少支出授权,应在提交前停止。如果结果是 review 或 inconclusive,应保持原收款 CLABE 继续有效,并开启复核工单;绝不能把不确定的相似度当作通过。如果任务一直处于待处理状态,或工作进程重启,应使用同一个 UUID 调用 get 或 recover,而不是重新提交,以免一次变更请求产生两笔费用。要记录哪些费用实际发生、哪些只是报价。技术故障不应在账本中悄悄变成已接受的支出。

需要明确的限制

姓名比对无法确认卖家是谁,也不能证明对方目前控制该账户。它只覆盖一个获准查询的 CLABE,而不是一批账户。文档和合成示例都不能证明进行过实时核查,也不能证明存在任何客户。合成输出不授予任何真实业务权限。产品反馈数据只是汇总计数,目前没有观察到使用记录,因此本文不对效果作任何声称。当前的访问权限、受支持的输入和费用以当前能力和已接受的报价为准,而不是以本文为准。

验收清单

在信任该集成之前,请确认:报价以本金、来源成本、服务费三条独立金额行保存;每条小额转账行都注明收款人和支出授权引用;授权引用和稳定请求 UUID 在提交前已持久化;重试时复用同一个 UUID;示例输出 status review、name_match inconclusive、verified false 和 automatic_business_approval false 会进入人工复核,且不更改收款信息;过期报价会强制重新报价;恢复操作不会产生重复任务;并且你的记录把该示例标注为合成合同证据,而不是实时验收。

检查这项功能

https://gridzen.ai/tools/mx-account-name/ · 核对输入、输出与能力边界。以下命令只读取产品说明,不执行真实请求。

gridzen tools --product mx-account-name

来源与范围

https://gridzen.ai/tools/mx-account-name/ https://gridzen.ai/guides/current-capabilities/ 依据已检查的来源快照与本地模拟;建议的业务规则属于设计建议,不代表已证明的生产行为。内容使用 AI 辅助写作,并经过独立审稿。

接入指南

接入你的应用

运行三种模拟结果 · 需要接入帮助

连接免费沙盒账号

号码基础有效性不证明持有权或送达,不提供短信验证码。业务放行由你的系统判断。