MPC - Múltiplas Capturas Parciais

Capturas Parciais Múltiplas (MPC) permite autorizar um valor uma vez e capturá-lo em várias solicitações. Use-o quando a entrega ocorre em etapas, por exemplo, quando os ingressos são confirmados, os produtos são enviados ou são concluídas as etapas de serviço.

A MPC é configurada por conexão com o processador. A conexão deve suportar autorização e captura, e a DEUNA deve ativar o modo de operação apropriado para essa conexão.

Para usar a MPC, integre com Criar pagamentos V2 e crie o pagamento usando a autorização em vez da captura automática.

Escolha um modo de operaçãoPerguntar à Athia sobre isto#

O modo online é apropriado apenas quando a conexão com o processador suporta múltiplas capturas nativamente. O modo offline é o modo de compatibilidade gerenciado pela DEUNA e também pode ser selecionado para um processador com MPC nativo quando as necessidades do negócio exigem o agrupamento de transações.

Ciclo de vida do MPC offlinePerguntar à Athia sobre isto#

1. O pagamento é authorized.
2. Cada solicitação de captura não final é validada em relação ao valor autorizado restante e armazenada sem chamar o processador.
3. Enquanto um ou mais valores de captura estiverem em buffer, o pagamento é partial_capturing.
4. A DEUNA encerra a sequência quando uma das seguintes condições ocorre:
   • O valor total solicitado atinge o valor autorizado.
   • A solicitação inclui "final_capture": true.
   • O limite de captura salvo é atingido.
5. A DEUNA envia o valor acumulado de captura ao processador como uma única operação de captura.
6. Se o valor total confirmado for igual ao valor autorizado, o pagamento se torna captured. Se o valor total confirmado for menor, o pagamento se torna partial_captured.

Encerrar uma sequência abaixo do valor autorizado marca a sequência de captura da DEUNA como final. Solicitações de captura subsequentes são rejeitadas. Consulte seu Gerente de Contas Técnicas da DEUNA (TAM) para saber como o valor autorizado restante é liberado pelo processador selecionado.

Encerrar a sequência através da API

Enviar final_capture como um booleano JSON, não como uma string:

{
  "amount": 100,
  "final_capture": true
}

O amount É o valor desta solicitação de captura. No modo offline, a DEUNA adiciona este valor aos valores de captura previamente armazenados antes de enviar a solicitação consolidada para o processador.

Limites de corte e tempo para a capturaPerguntar à Athia sobre isto#

O limite de corte para a captura offline tem as seguintes regras:

• Configure um número inteiro de 1 a 45 dias corridos.
• A DEUNA salva a data-limite absoluta em capture_cutoff_at . Para o pagamento, use esse timestamp, quando retornado, como fonte de verdade em vez de calcular o prazo localmente.
• Nas etapas de autorização que definem o momento final da autorização, o cronômetro começa quando a autorização é iniciada. Se ainda não houver um limite definido, o fluxo de captura o estabelece quando a primeira transação de captura não final é processada.
• O prazo final é o último dia do calendário de destino, e não um número exato de períodos de 24 horas após a solicitação.
• Capturas parciais posteriores não estendem ou reiniciam o prazo previamente definido.
• Alterar a configuração de conexão não altera um prazo já salvo em um pagamento existente.
• Quando o prazo definido é atingido, o pagamento se torna elegível para que o processo de fechamento da sequência seja executado. O processamento não é garantido no exato último segundo do dia, portanto, não confie em um período de graça para outros comerciantes.

O MPC online não possui um limite de captura da DEUNA. Os períodos de validade e limites de captura do processador ainda se aplicam.

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

• O valor total de captura não pode exceder o valor autorizado, após quaisquer reversões que afetem o saldo disponível.
• Ao atingir o valor autorizado, a solicitação é automaticamente finalizada; final_capture não é necessário nesse caso.
• Uma captura offline final abaixo do valor autorizado requer que o processador suporte a captura parcial.
• Após uma operação de captura final, a DEUNA não aceita mais capturas para essa sequência.
• A DEUNA não impõe um limite de número de requisições para capturas offline armazenadas. Os valores, limites, conexões e regras do processador são os limites efetivos.

Sempre calcule o pagamento com base nos valores confirmados. Uma captura armazenada não representa o dinheiro coletado do processador.

Status e tratamento de falhasPerguntar à Athia sobre isto#

Um tempo limite ou solicitação assíncrona aceita não provam que a captura foi bem-sucedida ou não. Recupere o pagamento e processe os webhooks da DEUNA até que um status confirmado esteja disponível. Uma captura online malsucedida preserva o estado de pagamento previamente confirmado, enquanto a operação falhada permanece visível no histórico da transação.

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

Configure o MPCPerguntar à Athia sobre isto#

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

No painel de administração, utilize os detalhes do pedido para monitorar as solicitações de captura, o valor acumulado, o valor autorizado restante e o limite de corte, quando disponível. A ativação, os credenciais e os limites do processador podem variar de acordo com o país e a conexão.