Skip to main content
As transferências P2P movem fundos entre contas da sua instituição na hora, sem custo por padrão, 24 horas por dia. Você pode configurar tarifas por organização. Veja Configuração de tarifas abaixo. A transferência nunca sai do seu sistema, então ela liquida de forma síncrona e dispensa a rede do BACEN.

​
Quando usar o P2P

O P2P é o tipo certo de transferência sempre que o remetente e o destinatário têm contas na sua instituição. Os cenários comuns incluem:
  • Mover dinheiro entre as contas do próprio cliente: um cliente transferindo da conta corrente para a conta poupança, ou entre duas contas que ele gerencia.
  • Pagar outro cliente da mesma instituição: um cliente enviando dinheiro para um amigo, um familiar ou uma empresa que também é cliente de vocês.
  • Movimentações internas de tesouraria: dividir saldos entre contas corporativas da mesma organização.
  • Divisão de pagamentos: distribuir valores entre várias contas para folha, divisão de despesas ou cashback.
O plugin detecta o P2P automaticamente. Quando o ISPB do destinatário corresponde ao ISPB da sua instituição, o plugin roteia a transferência internamente. A sua integração de API é idêntica à do TED OUT, então você não precisa de um endpoint nem de uma lógica à parte.

​
Principais vantagens

​
Como funciona

O P2P reutiliza a mesma API do TED OUT, então a sua integração fica consistente entre os tipos de transferência. O processo tem duas etapas do ponto de vista do cliente: Diagrama do fluxo P2P
  1. Iniciar: o cliente envia os dados da transferência. O plugin valida o destinatário, verifica o saldo do remetente e confirma a tarifa (em geral R$ 0,00). O cliente vê o resumo da transferência antes de efetivá-la.
  2. Confirmar: o cliente confirma. O plugin cria um débito + crédito atômico no Midaz. A transferência é concluída na hora.
O fluxo de duas etapas dá a você um momento natural para mostrar ao cliente uma tela de confirmação com o resumo completo da transferência antes de qualquer movimentação de fundos.

​
Estados da transferência

Diagrama da máquina de estados do P2P
O estado PENDING não se aplica às transferências P2P. O TED OUT usa PENDING para marcar os fundos que reserva enquanto aguarda o envio ao SPB. O P2P liquida inteiramente dentro do Midaz, então a transferência passa direto de PROCESSING para COMPLETED.

​
Configuração de tarifas

O plugin desabilita as tarifas por padrão. A maioria das instituições oferece transferências internas sem cobrança. A configuração de tarifas está disponível se o seu modelo de precificação precisar dela. Para habilitar tarifas de P2P, veja Configuração do TED.

​
Validação do destinatário

O destinatário deve ter uma conta na mesma instituição. Quando você envia uma transferência, o plugin procura o destinatário no CRM. Ele compara os dados bancários que você informa: ISPB, agência, conta e documento do titular. Se o plugin não acha o destinatário, ele rejeita a transferência e não move fundos. O cliente deve conferir os dados da conta e tentar de novo.

​
Integração técnica

O P2P usa os mesmos endpoints do TED OUT. Você não precisa de trabalho extra de integração além do fluxo de transferência de saída que já construiu.
O campo type na resposta da transferência é P2P. As transferências P2P não têm controlNumber, porque não passam pelo JD SPB.

​
Tratamento de erros

As transferências P2P são atômicas. O plugin cria o débito e o crédito como uma única transação no Midaz. Se qualquer parte falha, o Midaz não aplica nenhuma das pernas. Nenhum estado intermediário move fundos parcialmente nem deixa uma conta a descoberto. Se uma transferência falha, o cliente fica com o mesmo saldo e pode tentar de novo. Veja a lista completa de erros para os códigos de erro e a orientação de recuperação.