Pular para o conteúdo principal
POST
Criar um alias para uma Virtual Account
Disponibilidade: Argentina Esta operação permite que os comerciantes associem um pseudônimo personalizado e legível por humanos (pseudônimo CVU) a uma conta virtual ativa já existente na Argentina. Um alias substitui a CVU de 22 dígitos por uma sequência de texto curta e fácil de lembrar, reduzindo erros ao compartilhar os detalhes de pagamento.
Informações
  • O alias deve ser único em nível de país. Isso não é uma restrição da plataforma, mas uma exigência do sistema bancário argentino. Se outra CVU já usar o mesmo alias, a requisição será rejeitada.
  • Para atualizar um alias, chame este mesmo endpoint com o novo valor depois de decorrido o período de espera obrigatório de 24 horas.
  • Depois de criado ou atualizado, o alias não pode ser alterado novamente por 24 horas. Não há limite para o número total de alterações.
  • O alias é ativado de forma assíncrona. Uma resposta INPROGRESS não significa que o alias já esteja ativo. Verifique a ativação usando o endpoint Obtenha o status da sua Virtual Account.
  • Para verificar quais aliases estão ativos no momento em uma Virtual Account, use o endpoint Obtenha o status da sua Virtual Account.

Regras de formatação de alias

  • Apenas letras (a–z, A–Z), números (0–9) e pontos (.) são permitidos.
  • Espaços, hífens, sublinhados, arrobas (@) e outros caracteres especiais não são permitidos.
  • O comprimento deve estar entre 5 e 20 caracteres.
  • Exemplos válidos: alias.example, alias.example2026, alias.example.test

Melhores práticas

  • Utilize aliases significativos e consistentes para auxiliar na reconciliação interna e nos fluxos de suporte.
  • Registre as respostas de criação de aliases e associe-as aos seus registros de transações internas para facilitar a auditoria.
  • Utilize o endpoint de verificação de status periodicamente ou antes da cobrança do pagamento para verificar se o alias está ativo e mapeado corretamente.

Autorizações

Authorization
string
header
obrigatório

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

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso.

Parâmetros de caminho

externalId
string
obrigatório

O identificador único da conta virtual à qual você deseja adicionar um alias. Este deve ser exatamente o mesmo valor de externalId fornecido ao criar a conta virtual.

Corpo

application/json
type
enum<string>
obrigatório

Tipo de alias. Para a Argentina, o único valor válido é C (Personalizável — texto definido pelo usuário).

Opções disponíveis:
C
value
string
obrigatório

O valor de alias desejado. Somente letras (a–z, A–Z), números (0–9) e pontos (.) são permitidos. Deve ter entre 5 e 20 caracteres. Deve ser único em toda a plataforma. Exemplo: alias.example, alias.example2026.

Required string length: 5 - 20

Resposta

Criado

externalId
string

O identificador único da conta virtual. Este é o mesmo externalId que você forneceu na solicitação, confirmando que o alias foi criado para a conta correta.

alias
object

Informações do alias.

status
object

Informações de status.

Última modificação em 10 de novembro de 2026