FAQ de Transferências
Consulte as dúvidas mais comuns sobre transferências entre contas Asaas, Pix, TED, agendamentos e acompanhamento da operação.
Para implementar uma transferência, siga o guia correspondente ao destino.
Posso transferir um valor maior que o saldo disponível?
Não.
O valor da transferência deve ser menor ou igual ao saldo disponível na conta Asaas de origem.
Qual a diferença entre transferência para conta Asaas e para outra instituição?
| Destino | Como identificar |
|---|---|
| Conta Asaas vinculada | walletId |
| Conta bancária externa | bankAccount |
| Chave Pix | pixAddressKey e pixAddressKeyType |
Para contas Asaas, utilize Transferência para conta Asaas.
Para contas externas ou chaves Pix, utilize Transferência para contas de outra instituição.
Posso transferir para qualquer conta Asaas?
Não.
Transferências entre contas Asaas são permitidas somente quando existe vínculo entre as contas, como:
- conta principal e subconta;
- subconta e conta principal;
- subcontas da mesma hierarquia.
A conta de destino é identificada pelo walletId.
Como recupero o walletId?
walletId?Se o identificador não foi armazenado anteriormente, utilize:
GET /v3/wallets/Consulte o endpoint Recuperar WalletId.
Preciso informar se a transferência bancária será Pix ou TED?
Não necessariamente.
Ao transferir para uma conta bancária sem informar operationType:
- se a instituição de destino participar do Pix, a transferência será realizada via Pix;
- caso contrário, será realizada via TED.
Para definir a modalidade explicitamente, utilize operationType com PIX ou TED.
Posso transferir diretamente para uma chave Pix?
Sim.
Informe pixAddressKey e pixAddressKeyType.
Os tipos de chave disponíveis são:
CPF, CNPJ, EMAIL, PHONE e EVP.
Para chaves de telefone, informe 11 dígitos, incluindo o DDD. CPF e CNPJ devem ser enviados sem pontuação.
Posso agendar uma transferência Pix?
Sim.
Informe scheduleDate na criação da transferência.
Se o campo não for informado, a transferência Pix é processada sem agendamento.
Posso criar transferências Pix recorrentes?
Sim.
Utilize o objeto recurring ao criar uma transferência Pix para definir a recorrência.
Esse fluxo cria transferências periódicas e não gera QR Code para pagamento.
Consulte o guia de Pix Recorrente.
Pix Recorrente e Pix Automático são a mesma coisa?
Não.
No Pix Recorrente, o pagador configura uma transferência periódica.
No Pix Automático, o recebedor realiza cobranças recorrentes após autorização prévia do pagador.
Consulte a diferença entre Pix Recorrente e Pix Automático.
Como acompanho o resultado de uma transferência?
Em Produção, prefira Webhooks em vez de consultar repetidamente a API.
Para o resultado da operação, trate principalmente:
| Evento | Significado |
|---|---|
TRANSFER_DONE | Transferência concluída |
TRANSFER_FAILED | Transferência falhou |
TRANSFER_CANCELLED | Transferência cancelada |
Eventos como TRANSFER_PENDING, TRANSFER_IN_BANK_PROCESSING e TRANSFER_BLOCKED permitem acompanhar etapas intermediárias.
No evento, utilize transfer.id para relacionar a notificação à transferência criada. Quando houver falha, consulte transfer.failReason.
Consulte os Eventos para transferências.
Posso receber o mesmo evento de transferência mais de uma vez?
Sim.
Os Webhooks utilizam entrega at least once, portanto um evento pode ser reenviado.
Utilize o campo id do evento para garantir idempotência e evitar processar a mesma notificação mais de uma vez.
Quando devo consultar uma transferência com GET?
GET?Use GET /v3/transfers/{id} para consultas pontuais, recuperação manual ou quando precisar exibir os dados atuais de uma transferência.
Para manter sua integração sincronizada continuamente, utilize Webhooks.
Consulte o endpoint Recuperar uma única transferência.
Posso cancelar uma transferência?
Sim, desde que ela ainda não tenha sido efetivada.
Utilize:
DELETE /v3/transfers/{id}/cancelApós o cancelamento:
- o status passa para
CANCELLED; - o valor retorna ao saldo da conta de origem.
Transferências já efetivadas não podem ser canceladas por esse endpoint.
Consulte o endpoint Cancelar uma transferência.
Transferências entre contas Asaas são sempre instantâneas?
Na maioria dos casos.
O saldo normalmente fica disponível imediatamente na conta Asaas de destino.
Se a validação de evento crítico por Token APP ou Token SMS estiver habilitada, a transferência pode permanecer pendente até a autorização.
Como identifico a transferência no meu sistema?
Armazene o id retornado pelo Asaas.
Você também pode enviar externalReference na criação para relacionar a transferência ao identificador utilizado pelo seu sistema.
Transferir saldo para outra instituição é iniciação de pagamento via Open Finance?
Não.
Nesse fluxo, o recurso transferido já está disponível na conta Asaas e é enviado para outra instituição. Não há movimentação de uma conta externa nem consentimento de Open Finance.
Fluxos de iniciação de pagamento exigem uma integração específica com atuação de um iniciador de transação de pagamento.
Próximos passos
Updated about 14 hours ago