跳转到主要内容
请在付款前检查付款别名是否已激活,并查看隐藏的付款人详细信息。目前仅限哥伦比亚地区使用。 在发送付款之前,请使用此 endpoint 查询付款别名。它会返回别名的状态以及已注册所有者的脱敏信息,以便您确认该别名处于激活状态,并且指向预期的收款人。这是一个只读查询,不会创建交易,也不会预留资金。 调用此 endpoint 是可选的。您仍然可以直接通过通过银行转账汇款发送付款,而无需事先验证别名。事先检查可以减少因别名未激活或未注册而导致的付款失败。
目前仅限哥伦比亚使用。 countryISOCode 仅接受 CO,aliasClassification 仅接受 Breb(哥伦比亚的 Bre-B 即时支付系统)。未来可能会增加对更多国家和别名分类的支持。

开始之前

请确保您已备好:
  • 有效的API 凭证(访问令牌)。
  • 您想要验证的别名及其分类。

endpoint

完整的参数和模式详情也可在 Get Alias Detail API 参考中查看。

必需的标头

请求体

countryISOCode 使用 2 位代码(CO),而不是大多数其他 Localpayment endpoint 使用的 3 位代码(COL)。这与线上 API 一致,请勿在您的集成中将其“更正”。

示例请求

处理响应

成功响应

响应字段与脱敏

Localpayment 会对响应中的个人数据进行脱敏。仅返回下列字段,并且仅以脱敏形式返回。

错误处理

请务必在您的集成中处理这些情况,而不要假定每次查询都会成功。有关如何解读 Localpayment API 中的 HTTP 状态码和错误响应结构的一般指导,请参阅错误处理。

演示

使用示例别名试用查询,查看脱敏结果的显示方式。演示反映了当前的适用范围:仅限哥伦比亚。

下一步

通过银行转账汇款

使用您已验证的别名发送付款。

哥伦比亚

查看哥伦比亚支持的银行、证件类型和付款方式。
最后修改于 2026年11月10日