Skip to main content
As transferências P2P movimentam fundos entre contas dentro da sua instituição instantaneamente, sem custo por padrão, 24 horas por dia. Você pode configurar tarifas por organização — consulte Configuração de tarifas abaixo. A transferência nunca sai do seu sistema, então ela é liquidada de forma síncrona e não precisa da rede BACEN.

​
Quando usar P2P

P2P é o tipo de transferência adequado sempre que tanto o remetente quanto o destinatário possuem contas na sua instituição. Cenários comuns incluem:
  • Movimentação de dinheiro entre as próprias contas do cliente — um cliente transferindo da conta corrente para a conta poupança, ou entre duas contas que ele gerencia.
  • Pagamento para outro cliente na mesma instituição — um cliente enviando dinheiro para um amigo, familiar ou empresa que também é cliente da sua instituição.
  • Movimentações internas de tesouraria — divisão de saldos entre contas corporativas mantidas na mesma organização.
  • Divisão de pagamentos — distribuição de valores entre múltiplas contas para folha de pagamento, rateio de despesas ou cashback.
O plugin detecta P2P automaticamente. Quando o ISPB do destinatário corresponde ao ISPB da sua instituição, o plugin roteia a transferência internamente. Sua integração com a API é idêntica ao TED OUT, então você não precisa de um endpoint ou lógica separados.

​
Principais vantagens

​
Como funciona

O P2P reutiliza a mesma API do TED OUT, então sua integração permanece consistente entre os tipos de transferência. O processo é de duas etapas do ponto de vista do cliente: Diagrama de fluxo P2P
  1. Iniciar — O cliente submete os detalhes da transferência. O plugin valida o destinatário, verifica o saldo do remetente e confirma a tarifa (tipicamente R$ 0,00). O cliente vê o resumo da transferência antes de confirmar.
  2. Confirmar — O cliente confirma. O plugin cria um débito + crédito atômico no Midaz. A transferência é concluída imediatamente.
O fluxo em duas etapas oferece um momento natural para exibir 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 de máquina de estados P2P
O estado PENDING não se aplica a transferências P2P. O TED OUT usa PENDING para marcar os fundos que reserva enquanto aguarda a submissão ao SPB. As transferências P2P são liquidadas inteiramente dentro do Midaz, então a transferência vai diretamente 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 caso seu modelo de precificação precise dela. Para habilitar as tarifas P2P, consulte configuração do TED.

​
Validação do destinatário

O destinatário deve ter uma conta na mesma instituição. Ao submeter uma transferência, o plugin localiza o destinatário no CRM. O plugin usa os dados bancários que você fornece: ISPB, agência, conta e documento do titular. Se o plugin não encontrar o destinatário, ele rejeita a transferência e não movimenta fundos. O cliente deve verificar os dados da conta e tentar novamente.

​
Integração técnica

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

​
Tratamento de erros

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 falhar, o Midaz não aplica nenhuma das duas partidas. Nenhum estado intermediário movimenta fundos parcialmente ou deixa uma conta com saldo faltante. Se uma transferência falhar, o cliente mantém o mesmo saldo e pode tentar novamente. Consulte a lista completa de erros para códigos de erro e orientações de recuperação.