Status & Relatório do Fluxo de Pagamentos
Outlet Riccó — Gateway: Yapay/Vindi
🕐 Coletado em: 04/10/2026, 01:35:58
🕐 Coletado em: 04/10/2026, 01:35:58
⚙️ Configurações de Ambiente
💙 Fluxo PIX (Assíncrono)
Pedido criado com status 'pendente' na entidade Pedido
processarPagamentoYapay chamado → cria transação PIX na Yapay (método 27)
Pedido atualizado para 'aguardando_pagamento'. QR Code / Copia-e-Cola exibido na tela
E-mail enviado ao cliente e backoffice (pedidos1@ricco.com.br) com itens e data prevista de retirada
Yapay/Vindi detecta o pagamento e chama o webhook callbackYapay
Validação do secret (YAPAY_WEBHOOK_SECRET) via query param ?secret=... — rejeita 401 se inválido
Status atualizado + notificação criada para o cliente no Painel do Usuário
E-mail de confirmação enviado ao cliente e backoffice com todos os detalhes do pedido
Cliente cadastrado no Protheus → Pedido de venda criado → Estoque debitado automaticamente
💳 Fluxo Cartão de Crédito (Síncrono)
Pedido criado com status 'pendente' na entidade Pedido
processarPagamentoYapay chamado com método 3 (cartão de crédito)
Aprovação ou recusa retornada na hora. Pedido atualizado para 'pago' ou 'cancelado'
E-mail enviado ao cliente e backoffice com status do pagamento
Aprovação imediata → fecharPedidoERPInterno invocado → Cliente + Pedido no Protheus + Estoque debitado
🔒 Segurança
Configurado como secret de ambiente e validado em toda requisição ao callbackYapay
processarPagamentoYapay exige base44.auth.me() — não executa sem sessão válida
PROTHEUS_USERNAME e PROTHEUS_PASSWORD armazenados como secrets de ambiente
YAPAY_TOKEN_SANDBOX e YAPAY_TOKEN_PRODUCAO — alternância via YAPAY_SANDBOX=true/false
⚠️ Pontos de Atenção
- ERP Protheus usa HTTP simples (sem HTTPS) — recomendado migrar para VPN ou HTTPS em produção
- PIX: se o webhook não chegar, o pedido fica em 'aguardando_pagamento' — verificar via Admin ou verificarStatusYapay
- Cartão: aprovação instantânea, mas recusas devem ser comunicadas ao cliente no checkout
- Estoque é debitado automaticamente após confirmação — não há desfazimento automático em caso de cancelamento