Fluxo de Pagamento APM

Os métodos de pagamento alternativos (APMs) podem exigir um redirecionamento, troca de aplicativo, código QR, voucher, aprovação bancária ou confirmação tardia do provedor. Consulte o valor atual em payment.data.status; se o pagamento estiver dentro da resposta do pedido, consulte order.payment.data.status.

Use esta página para o caminho específico do APM. Para cada definição de status e transição direta permitida, consulte Fluxo e status de pagamento.

Fluxo APM padrão#

A maioria dos APMs começa em pending. Alguns confirmam imediatamente; outros permanecem pendentes enquanto o cliente age, então exibem processing enquanto a DEUNA aguarda a confirmação do provedor.

DEUNADiagrama de fluxoAmpliar

URLs de ação do cliente e retorno#

Siga o caminho específico do método next_action fornecido pela DEUNA. O retorno do navegador, aplicativo ou página de sucesso visível ao cliente não comprovam que o pagamento foi realizado. Confirme payment.data.status após a DEUNA receber e processar o resultado do provedor.

Se o cliente abandonar o redirecionamento ou fechar o navegador, mantenha o pagamento como pendente até que a DEUNA reporte um resultado. Não derive denied, cancelled, ou expired do comportamento da interface.

Períodos de conclusão#

O tempo permitido para completar um pagamento é específico do método e da configuração. A validade de vouchers, a validade de QR codes, os timeouts de sessão bancária e os períodos de processamento do provedor não são intercambiáveis.

Não calcule o status final do pagamento com base no tempo do navegador ou em um temporizador local. Mantenha o pagamento bloqueado e aguarde o relatório da DEUNA. processed, denied, cancelled, ou expired. Se a experiência do seu cliente exibe um contador, trate-o como orientação de apresentação, a menos que o contrato do método o torne autoritativo.

APMs com capacidade de autorização#

Algumas conexões de APM suportam autorização e captura. Esses métodos podem expor authorizing, authorized, capturing, capturedou estados parciais de captura, em vez do caminho padrão de compra.

Quando um APM utiliza autenticação, siga as Diretrizes para captura e cancelamento de transações com cartão. Para os status de pagamento compartilhados, mas confirme o suporte do método e do processador com seu Gerente de Contas Técnico da DEUNA (TAM). Não derive suporte para captura ou cancelamento com base na existência de um status no estado global.

Cancelamento e reembolsos#

cancelled Não é necessariamente o último estado financeiro. Se houve fundos arrecadados, o pagamento pode prosseguir. refunded; se houver uma autorização, ele pode prosseguir voided.

Após uma operação bem-sucedida processed Pagamentos e reembolsos podem ser processados. partial_refunding, partial_refunded, refundinge refunded quando o APM suporta. Consulte MPR – Reembolsos Parciais Múltiplos Para os modos suportados, limites de tempo, concorrência e comportamento do saldo restante.

Lista de verificação de integração#

1. Manter o processamento de pedidos bloqueado enquanto o pagamento estiver em andamento. pending ou processing.
2. Siga a próxima ação retornada, sem tratar o retorno do cliente como confirmação de pagamento.
3. Armazene referências e valores confirmados do provedor com cada atualização.
4. Gerencie notificações do provedor atrasadas e repetidas de forma idempotente.
5. Recupere o pagamento autorizado após um timeout ou ausência de retorno do cliente.
6. Use a referência de transição validada Para tentativas, reembolsos e caminhos de reconciliação que não estão no fluxo normal.