Transfira para outra instituição via Pix ou TED

Transfira o saldo disponível na conta Asaas para uma conta bancária externa ou diretamente para uma chave Pix.

Use POST /v3/transfers nos dois fluxos. Os dados do destino determinam como a transferência será realizada.

Antes de começar

Confirme que:

• a conta possui saldo disponível para a transferência;
• os dados bancários ou a chave Pix do destino estão corretos;
• sua integração está utilizando a API Key do ambiente correspondente.

O valor solicitado não pode ultrapassar o saldo disponível.

Escolha o destino

%%{init: {"flowchart": {"nodeSpacing": 28,"rankSpacing": 32,"diagramPadding": 8,"padding": 10}}}%%
flowchart TD
    A["Consultar o saldo disponível"] --> B{"Qual é o destino?"}

    B --> BConta(("Conta bancária"))
    B --> BPix(("Chave Pix"))

    BConta --> C["Informar bankAccount"]
    BPix --> D["Informar pixAddressKey"]

    C --> E["Criar a transferência"]
    D --> E

    E --> F["Armazenar o ID"]
    F --> G["Receber Webhooks"]
    G --> H["Conciliar o resultado"]

    classDef inicio fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A,stroke-width:3px,font-size:17px
    classDef decisao fill:#FEF3C7,stroke:#D97706,color:#78350F,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

    classDef respostaSim fill:#22C55E,stroke:#15803D,color:#FFFFFF,stroke-width:3px,font-size:16px
    classDef respostaOpcao fill:#8B5CF6,stroke:#6D28D9,color:#FFFFFF,stroke-width:3px,font-size:16px

    class A inicio
    class B decisao
    class C,D,E,F,G validacao
    class H sucesso

    class BConta respostaSim
    class BPix respostaOpcao

    linkStyle default stroke:#94A3B8,stroke-width:2px
    linkStyle 1 stroke:#22C55E,stroke-width:4px
    linkStyle 2 stroke:#8B5CF6,stroke-width:4px

1. Transfira para uma conta bancária

Informe bankAccount com os dados da conta de destino.

POST /v3/transfers

{
  "value": 1000.00,
  "bankAccount": {
    "bank": {
      "code": "237"
    },
    "ownerName": "Marcelo Almeida",
    "cpfCnpj": "52233424611",
    "agency": "1263",
    "account": "9999991",
    "accountDigit": "1",
    "bankAccountType": "CONTA_CORRENTE"
  }
}

Se precisar definir explicitamente a modalidade, utilize operationType com PIX ou TED.

O processamento varia conforme a modalidade:

Consulte o endpoint Transferir para conta de outra instituição ou chave Pix.

2. Transfira para uma chave Pix

Informe pixAddressKey e pixAddressKeyType.

POST /v3/transfers

{
  "value": 1000.00,
  "pixAddressKey": "09493012301",
  "pixAddressKeyType": "CPF",
  "scheduleDate": null,
  "description": "Churrasco pago via Pix com chave"
}

Os tipos de chave disponíveis são CPF, CNPJ, EMAIL, PHONE e EVP.

Ao informar a chave:

• telefone deve conter 11 dígitos, incluindo o DDD;
• CPF e CNPJ devem ser enviados sem pontuação.

3. Defina quando o Pix será executado

Uma transferência Pix pode ser:

recurring está disponível somente para transferências Pix.

Consulte o guia de Pix Recorrente.

O Pix Recorrente deste fluxo é uma transferência periódica. Ele não gera QR Code para pagamento.

4. Acompanhe a transferência por Webhook

Após criar a transferência, armazene o ID retornado e utilize Webhooks para acompanhar o processamento.

Para o resultado da operação, trate principalmente:

Outros eventos podem indicar etapas intermediárias, como processamento bancário ou bloqueio.

Consulte os Eventos para transferências.

Próximos passos

• Consulte a Introdução de Transferências
• Consulte a referência para transferências externas
• Configure transferências Pix recorrentes
• Configure os Eventos para transferências
• Transfira para uma conta Asaas vinculada