Conector 4P Finance
O conector executa exclusivamente no backend. O operador do Magnum administra uma credencial global da 4P na configuração privada da implantação, usando FOUR_P_API_KEY. Ela é diferente das chaves API dos negócios e nunca é devolvida a um negócio ou ao navegador. As Configurações de cada negócio não permitem consultar nem substituir essa credencial.
Contratos técnicos
| Operação | Contrato ou estado |
|---|---|
| Criar Pix | PUT /v1/pix/transaction |
| Consultar notificação | GET /v1/notification/:token |
| Cotação pública indicativa | Fontes independentes do Magnum, sem garantia de execução pelo fornecedor |
| Off-ramp | Adaptador isolado; contrato real não validado nesta entrega |
O payload de Pix do fornecedor contém documento do pagador, e-mail, valor, referência única, callback e custom_data.receiver_wallet. A página técnica descreve uma carteira do pagador no fluxo P2P. Essa documentação, sozinha, não autoriza liquidação comercial, carteiras de terceiros, revenda ou processamento de vários negócios com uma chave.
Recebimento do negócio
O negócio cadastra endereços fixos por rede e ativo compatível nas Configurações e no recurso autenticado /v1/console/workspaces/:workspaceId/settlement. Essa configuração é controlada pelo backend. O checkout do pagador e o corpo de criação da sessão não podem substituir o beneficiário.
A credencial global apenas centraliza a integração técnica. Antes de ativar pagamentos reais, o operador precisa obter aprovação expressa da 4P para o modelo comercial, negócios elegíveis, política de destinos e redes/ativos habilitados. Salvar uma chave ou endereço não comprova essa aprovação.
Política de pagamento fechada
A criação real permanece desativada. Variável de ambiente, chave API, destino salvo ou opção de iframe não supera essa política. O sandbox demonstra a integração sem gerar cobrança pagável.
O processamento de notificações persiste tokens e consulta dados no servidor. O estado documentado paid, sem metadados verificados de liquidação, registra somente o recebimento do Pix. Destino, rede, quantidade e hash precisam conferir antes de registrar liquidação cripto. Dados desconhecidos são isolados e eventos repetidos são deduplicados.
Fontes
Revisadas em 04/11/2026: credenciais, criação de transação, notificações e redes. Contratos técnicos não substituem o acordo comercial aplicável.
Os termos do fornecedor devem ser conferidos com o serviço efetivamente contratado e eventuais autorizações por escrito; exemplos técnicos de integração não substituem esse acordo.