Pular para o conteúdo principal

Header

Guia de operações e solução de problemas de pagamento

Este manual operacional abrange rotinas de diagnóstico, procedimentos de resolução de erros, estratégias de conciliação de pagamentos, controles administrativos e tratamento de reembolsos para as operações de pagamento da BDX.market.

1. Depuração e verificação de webhooks de pagamento​

Quando transações de gateway externo não são liquidadas automaticamente, os administradores inspecionam registros do sistema e executam rotinas manuais de reverificação.

Fluxo de eventos de webhook​

Todos os gateways externos de pagamento invocam endpoints centrais de verificação de pagamento:

POST /payments/webhook/{provider}
  ├─ Provider Route Security (only authorized providers accepted)
  ├─ Payment Gateway Manager processes webhook payload
  ├─ Cryptographic Signature & Verification Check
  ├─ Verify Order Total Match
  └─ Apply Result & Update Order Status

Ações de reverificação de gateway​

Se um webhook falhar devido a falha temporária de rede ou timeout, os administradores podem acionar a reverificação servidor a servidor do gateway sem pedir ao comprador para reenviar o pagamento:

  1. Localize a referência de pagamento pendente no painel administrativo de pagamentos.
  2. Inicie uma verificação manual de gateway para a transação.
  3. Após a verificação bem-sucedida, a custódia do pedido é ativada e o comprador é notificado na hora.

2. Cenários comuns de pagamento e resoluções​

A. Divergência de valor de pagamento​

  • Cenário: O comprador alterou o valor da transação durante a finalização no gateway externo, ou uma taxa de pagamento foi calculada incorretamente.
  • Resolução: Compare o registro da transação de pagamento com o total do pedido. Se pago a menor, a transação é rejeitada e reembolsada ou sinalizada para complementação. Se pago a maior, o saldo é ajustado manualmente pela equipe de suporte.

B. Erros de assinatura de verificação​

  • Cenário: Incompatibilidade de credenciais de API ou chave de descriptografia de payload corrompida.
  • Resolução: Verifique as credenciais do provedor nas suas configurações de pagamento. Garanta que as configurações de proxy do servidor não removam cabeçalhos personalizados de segurança.

3. Resolução de disputas e POP de reembolso​

Quando um comprador abre uma disputa ou solicita o cancelamento de um pedido, os valores em custódia são tratados conforme as políticas de proteção ao comprador da BDX.

[Dispute Filed by Buyer within 7 Days]
                 |
                 v
   Seller Given 24-Hour Notice to Respond
                 |
                 +---> Seller Resolves / Delivers Replacement -> Buyer Closes Dispute
                 |
                 +---> Seller Fails to Respond OR Item Proven Invalid
                          |
                          v
                 Admin Reviews Evidence in Support Dashboard
                          |
                          v
                 Execute Refund to Buyer BDX Wallet Balance

Padrão de execução de reembolso​

Reembolsos são processados diretamente de volta para o saldo interno da carteira BDX do comprador, independentemente de o método original de pagamento ter sido bKash, Nagad, Rocket, transferência bancária ou carteira BDX. Isso dá liquidez imediata ao comprador e disponibilidade instantânea para compras futuras (reembolsos cobrem o preço do item; taxas de proteção + gateway não são reembolsáveis) em todo o marketplace.

4. Conciliação do sistema e auditorias de saúde​

Para garantir a integridade do razão entre saldos de compradores, retenções de saque de vendedores e métricas de comissão do marketplace, verificações automatizadas de verificação são executadas regularmente:

  • Verificação de pagamentos pendentes: Inspeciona envios manuais de comprovante de pagamento que aguardam revisão da equipe.
  • Conclusão automática de pedidos: Conclui automaticamente pedidos entregues há mais de 7 dias sem disputas abertas e libera valores para os saldos em liberação dos vendedores.
  • Verificações de escalonamento de disputas: Identifica disputas em que os vendedores não responderam em até 24 horas e as sinaliza para revisão administrativa e reembolso.
Última atualização em