O que você pode construir
- Pagamento de folha: envie salários ou pagamentos a prestadores diretamente para as contas dos funcionários em qualquer banco brasileiro
- Pagamentos a fornecedores: pague faturas e liquide obrigações B2B sem acesso manual ao portal do banco
- Saques de clientes: deixe os clientes moverem fundos da sua plataforma para as contas bancárias externas deles sob demanda
- Movimentação interna de fundos: mova dinheiro entre contas da sua própria instituição, sem roteamento externo (P2P)
Tipos de transferência
Como funciona
- Iniciar: você informa os dados bancários do destinatário e o valor. O plugin mostra a tarifa antes
- Confirmar: você autoriza a transferência, e o plugin reserva os fundos no Midaz
- Enviar: o plugin assina o pagamento e o despacha pela rede STR do BACEN até o banco de destino
- Liquidar: o banco do destinatário credita os fundos, e você recebe o número de controle do JD SPB como confirmação
Horário de funcionamento e limites
O que os seus clientes podem esperar:
Fora da janela de funcionamento, o plugin rejeita a transferência e não move fundos. O erro indica o próximo horário disponível.
O que o plugin resolve para você
O seu time não precisa construir nem manter:
- Cálculo de tarifas: o plugin calcula as tarifas pelo Fees Engine na iniciação, antes de você confirmar
- Idempotência: uma nova tentativa da requisição leva uma chave de idempotência, então retorna o resultado original e nunca cria uma segunda transferência
- Conformidade com o BACEN: o plugin aplica a janela de funcionamento e registra uma trilha de auditoria completa
- Calendário de feriados: validação de dia útil do BACEN, apoiada na tabela
bacen_holidays(com carga para 2026–2099) - Notificações por webhook: os webhooks avisam o seu sistema quando uma transferência é concluída, chega ou falha
- Conciliação: cada transferência registra os timestamps e o histórico de status para auditoria
- Devoluções automáticas: uma transferência recebida que o plugin não consegue creditar pode voltar ao banco de origem. Quando o plugin não encontra a conta do destinatário, a transferência só é devolvida se a sua configuração autorizar devoluções automáticas. Caso contrário, o plugin retém a devolução para revisão de um operador. Isso é diferente de um chargeback, que estorna um crédito já concluído
- Devoluções a pedido: você pode devolver um TED concluído recebido como STR0008R2 ao banco de origem, ou estornar um P2P concluído, pela API

