Transferência para conta Asaas

Transfira saldo entre contas Asaas vinculadas utilizando o walletId da conta de destino.

Na maioria dos casos, a transferência é concluída imediatamente e o saldo fica disponível na conta recebedora.

Antes de começar

Tenha:

saldo disponível na conta de origem;
o walletId da conta de destino;
vínculo entre as contas envolvidas.

Se você não armazenou o walletId na criação da conta, recupere-o antes de realizar a transferência.

🚧
Atenção

Não é possível realizar transferências de uma conta Asaas para outras contas Asaas sem vínculo a sua.

Caso seja necessário, entre em contato com o nosso suporte técnico.

Como funciona

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Obter o walletId"] --> B["Validar o saldo disponível"]
    B --> C["Criar a transferência"]
    C --> D["Armazenar o ID"]
    D --> E["Receber Webhooks"]
    E --> F["Conciliar o resultado"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef validacao fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E,stroke-width:2px,font-size:17px
    classDef sucesso fill:#DCFCE7,stroke:#16A34A,color:#14532D,stroke-width:3px,font-size:17px

    class A inicio
    class B,C,D,E validacao
    class F sucesso

    linkStyle default stroke:#94A3B8,stroke-width:2px

1. Crie a transferência

Utilize:

POST /v3/transfers/

Informe o valor e o walletId da conta Asaas de destino:

{
  "value": 1000.00,
  "walletId": "0021c712-d963-4d86-a59d-031e7ac51a2e"
}

O campo externalReference também pode ser utilizado para relacionar a transferência a um identificador do seu sistema.

Consulte o endpoint Transferir para conta Asaas.

Resultado esperado

A API retorna os dados da transferência criada.

Armazene o id retornado para identificar a operação nos eventos e na conciliação.

2. Acompanhe a transferência por Webhook

Prefira Webhooks para acompanhar mudanças de estado em vez de consultar repetidamente a transferência pela API.

Para este fluxo, trate principalmente:

Evento	Como tratar
`TRANSFER_PENDING`	Mantenha a operação aguardando conclusão
`TRANSFER_DONE`	Confirme a transferência como realizada
`TRANSFER_FAILED`	Registre a falha e trate o motivo retornado
`TRANSFER_CANCELLED`	Atualize a operação como cancelada

Transferências entre contas Asaas são normalmente imediatas. 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.

Consulte os Eventos para transferências.

Próximos passos

Updated about 14 hours ago

Did this page help you?