MPC - Múltiplas Capturas Parciais
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:
- Autorização: O cliente autoriza o valor total da transação.
- Múltiplas capturas: A loja capta partes do valor autorizado em datas diferentes.
- 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": truena 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âmetro | Descrição | Valores permitidos | Valor padrão |
|---|---|---|---|
| Estado | Ativa ou desativa MPC | on / off | off |
| Fuso horário operacional | Fuso horário operacional para calcular dias úteis | Fuso horário válido | UTC |
| Dias limite de captura | Dias permitidos para captura após autorização | 0-45 | 7 |
| Capturar corte via API | Permite indicar a captura final utilizando "final_capture": true na API | true / false | false |
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:
- Selecione o processador em Conexões.
- Se o processador suportar compra e autorização, clique em autorizar.
- CliqueMúltiplas Capturas Parciais (DEUNA).
- 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:
- O prazo de captura foi atingido.
- O valor total autorizado é capturado.
- O comerciante envia
final_capturecom o valortrueno pedido.
Exemplo:
{
"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 → statuscaptured. - 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.