跳转到主要内容
POST
为虚拟账户创建别名
适用地区:阿根廷 此操作允许商家将自定义的、易于理解的别名(CVU 别名)与阿根廷现有的有效虚拟账户关联起来。 别名会将 22 位 CVU 替换为简短易记的文本字符串,从而减少共享付款详情时的错误。
信息
  • 别名必须在国家层面保持唯一。这不是平台限制,而是阿根廷银行系统的要求。如果其他 CVU 已使用相同的别名,请求将被拒绝。
  • 如需更新别名,请在所需的 24 小时等待期结束后,使用新值调用同一接口。
  • 别名一经创建或更新,24 小时内无法再次更改。更改总次数没有限制。
  • 别名为异步激活。返回 INPROGRESS 并不意味着别名已经生效。请使用获取虚拟账户状态接口验证激活情况。
  • 如需查看某个虚拟账户上当前有哪些别名处于活动状态,请使用获取虚拟账户状态接口。

别名格式规则

  • 仅允许使用字母(a–z、A–Z)、数字(0–9)和英文句点(.)。
  • 不允许使用空格、连字符、下划线、@ 符号(@)以及其他特殊字符。
  • 长度必须介于 5 到 20 个字符之间。
  • 有效示例: alias.example、alias.example2026、alias.example.test

最佳实践

  • 使用有意义、一致的别名来帮助内部核对和支持流程。
  • 记录别名创建响应,并将其与内部交易记录关联,以便于审计。
  • 定期或在收款前使用状态检查 endpoint 来验证别名是否处于活动状态并已正确映射。

授权

Authorization
string
header
必填

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

请求头

Authorization
string
必填

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

路径参数

externalId
string
必填

要添加别名的虚拟账户的唯一标识符。这必须与您创建虚拟账户时提供的 externalId 值完全一致。

请求体

application/json
type
enum<string>
必填

别名类型。对于阿根廷,唯一有效值为: C (可自定义——用户自定义文本)。

可用选项:
C
value
string
必填

所需的别名值。仅允许字母(a–z、A–Z)、数字(0–9)和点(.)。长度必须在 5 到 20 个字符之间。在整个平台上必须唯一。例如:alias.example、alias.example2026。

Required string length: 5 - 20

响应

创建

externalId
string

虚拟账户的唯一标识符。这与您在请求中提供的 externalId 相同,确认别名已为正确的账户创建。

alias
object

别名信息。

status
object

状态信息。

最后修改于 2026年11月10日