Gerar conta de recebimento

Gera uma CLABE nova (México) e já vincula à sua conta. Isto é irreversível do lado do banco. A conta nasce no banco parceiro e não pode ser apagada de lá — remover pela API tira apenas o vínculo aqui. Por isso existem duas travas: a descrição é obrigatória e há um teto por conta. A primeira conta de recebimento é liberada pela nossa operação. Enquanto isso não acontece, esta chamada responde 403 — fale com o suporte.

POST/receiver-accounts

Autenticação

HTTP Basic Auth. Envie sua secret key no header:

Authorization: Basic {base64(secret:SUA_SECRET_KEY)}

Parâmetros

labelstringobrigatório

Como você identifica esta conta. Obrigatório: uma lista de contas sem descrição é uma lista de números.

Exemplo: Jogadores VIP

Body da requisição

Content-Type: application/json

JSON

{
  "label": "Jogadores VIP"
}

Respostas

201

Conta criada.

JSON

{
  "id": "b5f1c3a2-7d4e-4a91-9c02-1f8e6d3b0a55",
  "account": "646180111812345678",
  "label": "Jogadores VIP",
  "method": "SPEI",
  "currency": "MXN",
  "active": true,
  "createdAt": "2026-09-15T13:37:13.752Z"
}

400

Sem descrição, ou o provedor recusou a emissão.

JSON

{
  "error": "Informe uma descrição para identificar esta conta."
}

403

Conta ainda não liberada para gerar contas de recebimento.

JSON

{
  "error": "Esta conta ainda não está habilitada para gerar contas de recebimento. Fale com o suporte."
}

409

Teto de contas atingido.

JSON

{
  "error": "Limite de 1000 contas de recebimento atingido. Fale com o suporte para ampliar."
}