Transferência para contas de outra instituição (Pix / TED)

Contexto da operação

Este endpoint refere-se a transferências realizadas via Pix ou TED a partir do saldo disponível na conta Asaas.

Nessa operação:

• o saldo do cliente já está custodiado no Asaas;
• a transação é caracterizada como transferência para outra instituição;
• o Asaas atua como PSP pagador.

🛑

Importante

Este fluxo não caracteriza iniciação de pagamento via Open Finance (ITP).

Apesar de, na experiência, a operação envolver o envio de recursos para outra instituição, do ponto de vista regulatório e operacional:

• não há consentimento de Open Finance;
• não há acesso ou movimentação de conta externa;
• não há movimentação de saldo mantido em outra instituição financeira;
• não há atuação do Asaas como iniciador de transação de pagamento (ITP).

Ou seja, trata-se exclusivamente de uma transferência realizada a partir de saldo próprio do cliente dentro do Asaas.

Uso correto do endpoint

Este endpoint deve ser utilizado apenas para transferências realizadas com saldo disponível na conta Asaas.

Para cenários de iniciação de pagamento via Open Finance, é necessário utilizar fluxos específicos com consentimento do usuário e integração com um iniciador (ITP).

Transferência para conta de outra instituição

Informe os campos bankAccount para realizar a transferência para uma conta bancária.

Caso seja realizada via Pix, a transferência ocorre instantaneamente ou na data de agendamento.

Para TED, a transferência permanece pendente até o processamento bancário, que pode ocorrer no mesmo dia ou no próximo dia útil, dependendo do horário da solicitação.

POST /v3/transfers
Confira a referência completa deste endpoint

Exemplo de requisição

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

📘

Aviso

Caso não seja informado operationType e a conta bancária pertença a um banco ou instituição de pagamento participante do Pix, a transferência será realizada via Pix.

Caso contrário, será realizada via TED.

Transferência para uma chave Pix

Informe os campos pixAddressKey e pixAddressKeyType para realizar uma transferência para uma chave Pix.

POST /v3/transfers
Confira a referência completa deste endpoint

Exemplo de requisição

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

A transferência pode ser realizada:

• de forma instantânea;
• agendada, informando o campo scheduleDate;
• recorrente, informando o campo recurring.

📘

Saiba mais

Saiba mais sobre Pix recorrente na documentação específica.

Validação de chaves Pix

• Chaves do tipo telefone devem conter 11 dígitos, incluindo o DDD.
  Exemplo: 47999999999
• Chaves CPF ou CNPJ devem ser informadas sem pontuação.

Considerações finais

Este endpoint realiza exclusivamente transferências utilizando saldo previamente disponível na conta Asaas.

⚠️

Atenção

Este endpoint não deve ser utilizado para fluxos de iniciação de pagamento via Open Finance.

Para integrações com Open Finance, é necessário utilizar um fluxo específico com:

• consentimento do usuário;
• integração Open Finance;
• atuação de um iniciador de transação de pagamento (ITP).