Pular para o conteúdo principal
Nesta página

Múltiplas capturas parciais (MPC) é uma funcionalidade que permite autorizar um valor total e capturá-lo em várias partes ao longo do tempo.

Atende modelos de negócios que exigem captura progressiva de pagamentos.

Por exemplo: emitir tickets à medida que forem confirmados ou cobrar quando os itens estiverem de volta ao estoque e prontos para serem enviados.

Casos de uso#

Esta funcionalidade é especialmente útil para:

  • Companhias aéreas: Autorize o valor total do ingresso e capture parcialmente à medida que os assentos forem confirmados.
  • Varejo com remessas parciais: Ideal para mercados onde os pedidos são despachados por vários vendedores e os itens são enviados em horários diferentes.
  • Entrega de serviço em etapas: Capture pagamentos à medida que as fases do projeto são concluídas.

Como funciona o MPC#

Um fluxo MPC funciona da seguinte maneira:

  1. Autorização: O cliente autoriza o valor total da transação.
  2. Múltiplas capturas: A loja capta partes do valor autorizado em datas diferentes.
  3. Consolidação: O sistema gerencia múltiplas capturas e as envia ao processador de acordo com as regras configuradas:
    • Processadores on-line: As capturas são enviadas em tempo real após autorização.
    • Processadores off-line: As capturas são enviadas após autorização, quando alguma das seguintes condições for atendida:
      • O prazo de captura definido foi atingido.
      • O valor total autorizado é capturado.
      • O comerciante envia "final_capture": true na solicitação da API.

Configuração e requisitos#

A funcionalidade MPC requer ativação prévia e os seguintes parâmetros de configuração:

Configuração principal#

A tabela a seguir documenta a configuração principal do MPC:

ParâmetroDescriçãoValores permitidosValor padrão
EstadoAtiva ou desativa MPCon / offoff
Fuso horário operacionalFuso horário operacional para calcular dias úteisFuso horário válidoUTC
Dias limite de capturaDias permitidos para captura após autorização0-457
Capturar corte via APIPermite indicar a captura final utilizando "final_capture": true na APItrue / falsefalse

Configurar MPC no Admin#

Execute as seguintes tarefas de MPC no Administrador:

  • Configure os parâmetros MPC.
  • Monitore capturas pendentes.
  • Verifique a data de processamento agendada.
  • Veja o valor restante disponível para captura.

Para ativar este recurso:

  1. Selecione o processador em Conexões.
  2. Se o processador suportar compra e autorização, clique em autorizar.
  3. CliqueMúltiplas Capturas Parciais (DEUNA).
  4. Defina o número de dias após a primeira captura durante os quais capturas parciais adicionais podem ser realizadas.

Os dias configurados para captura parcial podem ser modificados a qualquer momento.

Porém, as alterações não se aplicam a transações que já iniciaram capturas parciais.

No detalhe do pedido será exibido o prazo de captura. Nessa data, todas as capturas pendentes serão processadas.

Modos de operação#

Descubra como operar o MPC com DEUNA.

Limites de captura parcial:*

  • Modo off-line: Nenhum limite técnico da plataforma.
  • Modo on-line: Os limites dependem das regras de cada processador.

Off-line

Aplica-se quando o adquirente/processador não lida nativamente com múltiplas capturas.

As capturas são consolidadas e enviadas ao processador quando qualquer uma das seguintes condições for atendida:

  1. O prazo de captura foi atingido.
  2. O valor total autorizado é capturado.
  3. O comerciante envia final_capture com o valor true no pedido.

Exemplo:

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

Estado:

Embora existam capturas pendentes, o status será partial capturing.

Se o valor total for concluído, o status mudará para captured.

Caso o prazo seja atingido sem a captura do total, o status será partial captured.

Processadores sob fluxo de liquidação (Elavon, Amex, UATP, BBVA)

Esses processadores sempre operam em modo offline.

O estatuto permanece partial capturing até:

  • O total é capturado → status capturing → pós-liquidação → status captured.
  • O total não é capturado dentro do prazo → status partial captured.

On-line

As capturas são enviadas em tempo real para o processador, caso este suporte nativamente MPC.

Alguns processadores exigem credenciais ou habilitações específicas (por exemplo: Stripe, Adyen).

Estado

Capturas parciais geram status partial captured.

Ao capturar o total, o status muda automaticamente para captured.

Regras

  • A soma de todas as capturas não pode ultrapassar o valor autorizado.
  • Não são permitidas capturas fora do período de elegibilidade ou após o envio "final_capture": true.