Contas, chaves e identificadores

Cada credenciamento na Accelerazione cria uma conta, com uma chave de API por ambiente. A chave identifica a conta em toda chamada: por isso nenhuma rota pede o identificador da conta no corpo para saber quem está cobrando. Os outros identificadores desta página servem para apontar qual saldo, qual recebedor ou qual conta bancária você quer consultar ou movimentar dentro da sua conta.

Operação doméstica e offshoreCopiar link da seção

Se você vende tanto no Brasil (BRL) quanto no exterior (USD), a operação doméstica e a offshore são credenciamentos separados. Cada um tem a sua própria chave de API, os seus recebedores, o seu escopo (Domestic ou Offshore) e a sua conta de saldo, no sandbox e em produção.

Use a chave de cada operação nas vendas daquela operação. O escopo da venda vem da chave que criou a cobrança.

O escopo também precisa ser coerente na sessão 3DS: envie em transaction_scope o escopo da conta da chave que abre a sessão.

Os identificadores de uma contaCopiar link da seção

Três números diferentes podem aparecer quando você fala do dinheiro da sua conta. Eles não são intercambiáveis: cada rota aceita só o seu.

O accountId e o número interno são entregues no credenciamento, um par por operação e por ambiente. O accountNumber existe só quando há uma conta bancária vinculada à sua conta no provedor.

Três consequências práticas:

• Saldo e extrato são consultas diferentes. O saldo mostra o que a Accelerazione registrou na sua conta interna, separado entre disponível, bloqueado e reservado. O extrato mostra as movimentações da conta bancária no provedor. Os valores dos dois não precisam coincidir.
• Ter accountId não garante extrato. O credenciamento da conta interna não cria, sozinho, uma conta bancária vinculada. Sem esse vínculo, o extrato responde 404 Statement.BankAccountNotFound e o saque não tem conta de origem para executar.
• Não troque um número pelo outro. Enviar o número interno em accountNumber, ou o accountNumber em accountId, resulta em 404 ou 400, nunca em dados de outra conta.

Sandbox e produçãoCopiar link da seção

Os identificadores de sandbox e de produção são diferentes, assim como as chaves. Guarde-os em configuração por ambiente, junto com a chave, e nunca reaproveite um identificador de sandbox em produção.

O que pedir no credenciamentoCopiar link da seção

Para cada operação (doméstica e, se houver, offshore) e para cada ambiente:

1. A chave de API, com as permissões das rotas que você vai usar.
2. Os recipientId dos recebedores usados no split.
3. O accountId da conta de saldo, se você vai consultar saldo ou sacar.
4. O accountNumber da conta bancária vinculada, se você vai consultar o extrato.
5. As origens HTTPS dos seus checkouts, para o 3DS.