跳转到主要内容
POST
获取别名详情
请在付款前检查付款别名是否已激活,并查看隐藏的付款人详细信息。目前仅限哥伦比亚地区使用。 有关完整的响应字段参考、掩码规则、错误处理指南和交互式演示,请参阅验证付款别名。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求头

Authorization
string
必填

用于身份验证的 Bearer 访问令牌。该令牌可从获取访问令牌或刷新访问令牌endpoint 获取。

请求体

application/json
countryISOCode
enum<string>
必填

别名所在国家/地区,采用 ISO 3166-1 alpha-2 格式(而非 alpha-3,这与其他大多数本地支付 endpoint 不同)。目前仅 CO (哥伦比亚)获得支持。

可用选项:
CO
aliasClassification
enum<string>
必填

别名分类。目前仅 Breb 支持(哥伦比亚的 Bre-B 即时支付系统)。

可用选项:
Breb
aliasValue
string
必填

要验证的别名(电话号码、文档、电子邮件、商户代码或字母数字密钥)。

响应

OK

firstName
string

别名所有者的注册名字。

lastName
string

别名所有者的注册姓氏。已屏蔽:显示前两个字母,其余字母替换为星号(Doe 变成 Do**)。

status
string

别名的当前状态。

示例:

"ACTIVE"

idType
string

所有者身份证明文件的类型。请参阅支持的证件类型。

idValue
string

所有者的身份证件号码。已做掩码处理:仅显示最后 4 位数字,其余替换为星号(20304050 变为 ****4050)。

aliasType
string

已解析别名的分类(身份证明文件、商户代码、手机号码、电子邮件地址或字母数字密钥)。已确认的有效值以大写字母表示,例如: PHONE ;其他各类别的具体字符串尚未确定。

aliasValue
string

您查询的别名已完整返回。

bankName
string

别名注册银行的名称。

最后修改于 2026年11月10日