MPR - Reembolsos Parciais Múltiplos

Múltiplos Reembolsos Parciais (MPR) permite que um comerciante envie várias solicitações de reembolso parcial enquanto a DEUNA envia um único reembolso acumulado ao processador. É o modo de compatibilidade gerenciado pela DEUNA para conexões que não podem receber múltiplas operações de reembolso ou cujo processamento de reembolsos exige agregação.

O MPR é configurado por conexão com o processador. Ele difere dos múltiplos reembolsos nativos: com suporte nativo, cada reembolso elegível pode ser enviado ao processador de forma independente; com o MPR, as solicitações não finais permanecem armazenadas na DEUNA até que a sequência seja encerrada.

Ciclo de vida do MPRPerguntar à Athia sobre isto#

1. Inicie a partir de um pagamento com um valor reembolsável confirmado, por exemplo processed, captured, ou partial_captured.
2. Envie um valor de reembolso parcial.
3. A DEUNA valida a solicitação em relação ao saldo reembolsável acumulado e a armazena sem chamar o processador.
4. Enquanto um ou mais valores de reembolso estiverem armazenados, o pagamento estará em partial_refunding.
5. A DEUNA encerra a sequência quando uma das seguintes condições ocorre:
   • O valor total solicitado atinge o valor reembolsável total.
   • A solicitação inclui "final_refund": true.
   • O corte de reembolso salvo é atingido.
6. A DEUNA envia o valor acumulado em buffer para o processador como uma única operação de reembolso.
7. Se o valor reembolsado confirmar o saldo total reembolsável, o pagamento se torna refunded. Se apenas parte desse saldo for reembolsado, o pagamento se torna partial_refunded.

O pedido em buffer registra a intenção de reembolso; ele não comprova que os fundos foram devolvidos ao cliente.

Limite de corte e prazos para reembolsoPerguntar à Athia sobre isto#

O limite de corte do MPR tem as seguintes regras:

• Configure um número inteiro de 1 a 45 dias corridos.
• O cronômetro começa quando o primeiro reembolso não final é registrado.
• A DEUNA salva a data-limite absoluta em refund_cutoff_at . Reembolsos parciais posteriores não a estendem nem a redefinem.
• O prazo é o final do dia de calendário, e não o mesmo horário após um número fixo de dias.
• Alterar a configuração de conexão não altera um prazo já salvo em um pagamento existente.
• Quando o limite de corte salvo é atingido, o pagamento se torna elegível para que o worker de corte envie o valor acumulado de reembolso. O processamento não é garantido no exato último segundo do dia, portanto, não confie em um período de graça para reembolsos de outros comerciantes.

Por exemplo, com um limite de corte de um dia, um primeiro reembolso não final registrado na segunda-feira é elegível para processamento após o final da terça-feira. Não é agendado para o mesmo horário na terça-feira.

Encerrar a sequência através da APIPerguntar à Athia sobre isto#

Use final_refund para enviar a solicitação atual e todos os valores acumulados anteriormente, sem esperar pelo limite de corte. Envie-o como um JSON booleano:

{
  "amount": 100,
  "reason": "Item returned",
  "final_refund": true
}

Alcançar o valor reembolsável total também fecha automaticamente a sequência; final_refund não é necessário nesse caso.

Valor e regras da sequênciaPerguntar à Athia sobre isto#

• A soma total solicitada de reembolso não pode exceder o valor reembolsável confirmado.
• A DEUNA inclui reembolsos anteriores em buffer ao validar cada nova solicitação.
• Uma operação de reembolso final fecha a sequência do MPR. Solicitações posteriores de reembolso para essa sequência são rejeitadas.
• A DEUNA não impõe um limite de contagem de solicitações para solicitações MPR em buffer. O saldo reembolsável e o limite de corte são os limites efetivos da plataforma.
• Não calcule o saldo restante apenas com a última resposta. Use a última transação, seu histórico de operações e valores confirmados, especialmente quando as solicitações podem se sobrepor.
• Se a operação de captura ainda estiver pendente, a elegibilidade para reembolso é específica para a conexão. Não reembolse um valor não confirmado, a menos que a DEUNA tenha aprovado o comportamento de captura e reembolso simultâneo para a conexão.

Status e tratamento de falhasPerguntar à Athia sobre isto#

Se o processamento ou a chamada ao processador falharem, não marque o pagamento como reembolsado localmente. A DEUNA pode tentar novamente o trabalho de corte elegível, enquanto falhas repetidas e não resolvidas exigem revisão operacional. Recupere o pagamento e consuma webhooks até que a operação atinja um status confirmado. Um tempo limite sozinho não representa um resultado final de reembolso.

Para a tabela completa de transição, consulte Fluxo de Pagamento & Statuses. Para solicitações sobrepostas, consulte Captura e reembolso simultâneos.

Configurar MPRPerguntar à Athia sobre isto#

Trabalhe com seu TAM da DEUNA para configurar a conexão:

No painel de administração, use o detalhe do pedido e o histórico da operação de reembolso para monitorar as solicitações em buffer, o valor acumulado de reembolso, o saldo reembolsável restante e o corte agendado, quando disponível.

MPC e MPR podem ser habilitados na mesma conexão. Seus cortes de captura e reembolso são independentes; atualizar um não afeta o outro.