> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Captura de pagamento
> Como evitar pagamentos perdidos nos seus pedidos de upsell pós-compra
***
## Captura de pagamento
Se a sua loja está usando a captura manual de pagamento, você pode estar vendo alguns pedidos com status de parcialmente pago. Este artigo mostrará como resolver esse problema mantendo suas configurações de captura manual de pagamento.
***
## Por que isso acontece
Se a sua loja usa um app de detecção de fraudes (por exemplo, **NoFraud** ou **Riskified**), o app de detecção de fraudes pode não oferecer suporte nativo a upsells pós-compra. Nesses casos, ele frequentemente captura o pagamento do pedido cedo demais, antes de o upsell pós-compra ser adicionado. O pagamento do upsell pós-compra será autorizado, mas apenas o pagamento inicial será capturado. Esse pedido apareceria como **Parcialmente pago**.
Além disso, o momento em que o app de fraudes captura o pagamento pode interferir na lógica de limpeza de itens do Aftersell. Se o app de fraudes capturar o pagamento original **depois** que a autorização do upsell falhar, o Aftersell pode não remover o item de upsell não pago do pedido como esperado. Isso pode resultar em clientes recebendo produtos gratuitamente.
***
## Como corrigir
Primeiro, você precisa confirmar se está atualmente usando a captura manual de pagamento. Se não estiver, infelizmente o restante deste artigo não se aplica a você.
### Confirme suas configurações de captura de pagamento
Sua loja pode ter um sistema de captura automática de pagamento configurado e, ainda assim, ter a configuração de captura manual de pagamento da Shopify ativada. Você pode confirmar as configurações de captura de pagamento da sua loja em:
**Shopify Admin > Settings > Payments > Payment Capture Method**
Se você está atualmente na captura manual de pagamento, continue lendo!
### Criando um Shopify Flow
A solução mais simples para garantir que todos os pagamentos de um pedido sejam capturados é usar um **Shopify Flow**. Abaixo está uma imagem de um Shopify Flow que faz isso:
### Explicando o Flow
Este flow tem 3 etapas:
1. **Um gatilho** é definido para garantir que o flow só seja iniciado quando uma transação de pedido for criada. A primeira transação de um pedido é criada quando o cliente faz o pedido. Uma transação adicional é criada se o cliente aceitar o upsell pós-compra do Aftersell. Nosso objetivo é capturar o pagamento da segunda transação, por isso verificaremos algumas condições na próxima etapa.
2. **Condições** são definidas para garantir que o flow só continue em determinados cenários. Só queremos que este flow continue se a transação criada for de um upsell pós-compra. Também não queremos executar este flow se o pagamento do pedido original ainda não tiver sido capturado. Este flow serve apenas para capturar pagamentos adicionais que foram perdidos. Se nenhum pagamento tiver sido capturado ainda, não faremos nada neste flow e assumiremos que o sistema normal de captura de pagamento capturará o valor total.
3. **Capturar o pagamento** quando todas as suas verificações forem aprovadas. Isso capturará o pagamento apenas do valor extra do upsell pós-compra. Problema resolvido!
Depois de implementar o flow acima, se você usa serviços externos de fulfillment, certifique-se de que o Flow de captura de pagamento não tenha efeitos indesejados no seu fulfillment. Para mais detalhes sobre fulfillment, consulte nossa [documentação de Fulfillment](/pt/aftersell/fulfillment).
***
## Captura de pagamento de upsell pós-compra não funciona
\
Esta seção se aplica se você está enfrentando um **pico recente** de pedidos parcialmente pagos especificamente em upsells pós-compra, mesmo que não use um app de detecção de fraudes.
\
### O que mudou
A Shopify atualizou seu modelo de automação integrado **"Capture payment if order is not high fraud risk"** por volta de **31 de março de 2026**. Essa atualização mudou a forma como a Shopify avalia o risco de fraude em edições de pedidos, o que quebrou a captura automática de pagamento para upsells pós-compra.
Antes, a Shopify reexecutava a análise de fraude quando um pedido era editado (por exemplo, quando um item de upsell pós-compra era adicionado). Essa mudança de nível de risco reacionava o flow do modelo de captura de pagamento, capturando o pagamento do upsell. A Shopify não reexecuta mais a análise de fraude em edições de pedidos, então o flow do modelo não é reacionado e o pagamento do upsell não é capturado.
Esse problema afeta lojas **com ou sem** um app de detecção de fraudes.
### Sintomas
Você pode estar enfrentando esse problema se:
* Você notou um pico repentino de pedidos **Parcialmente pagos** em upsells pós-compra
* Apenas pedidos em que um cliente aceitou um upsell pós-compra estão aparecendo como Parcialmente pagos
* O pagamento do pedido original é capturado, mas o pagamento do upsell está **autorizado e não capturado**
* Você não alterou nada nas configurações da sua loja na época em que o problema começou
### Como corrigir
**Use o modelo de Flow do Aftersell para uma configuração com um clique.** O Aftersell publica um modelo de Flow pré-construído chamado **"Capture payment when a post-purchase upsell is accepted"** na biblioteca de modelos do Flow da Shopify. Você pode instalá-lo diretamente do app Flow sem construir o fluxo de trabalho manualmente. Procure por ele na biblioteca de modelos do Flow, na categoria **Orders**.
Se você preferir construir o flow manualmente, crie um novo **Shopify Flow** com a seguinte configuração:
1. **Gatilho:** "Aftersell Post Purchase Offer Accepted" — dispara quando um cliente aceita uma oferta de upsell pós-compra do Aftersell e o item é adicionado com sucesso ao pedido.
2. **Condição:** "Order capturable is equal to True" — garante que o flow só tente capturar o pagamento quando o pedido estiver em um estado em que a captura é possível.
3. **Ação:** "Capture payment" — se a condição for verdadeira, o flow captura o pagamento pendente referente ao valor do upsell.
\
**Não adicione uma condição de valor de presentment money.** Algumas lojas tiveram problemas em que a Shopify retorna incorretamente o valor de presentment money como 0, mesmo quando há um saldo pendente. Adicionar uma condição como "presentment money amount is greater than 0" pode fazer o flow pular a captura de pagamento em pedidos válidos. Isso pode resultar em clientes recebendo e-mails de fatura em vez de terem o pagamento capturado automaticamente. Mantenha o flow simples: gatilho, verificação de capturável, captura de pagamento.
\
\
Sua automação existente da Shopify para capturar o pagamento do pedido original pode permanecer como está. Este novo flow é executado em paralelo e cuida apenas do pagamento do upsell pós-compra.
\
### Depois de configurar o Flow
* **Teste o flow** em uma loja de desenvolvimento ou sandbox antes de ativá-lo em produção.
* **Monitore seus pedidos** por alguns dias após ativar o flow para confirmar que os pagamentos estão sendo capturados como esperado e que nenhum e-mail de fatura está sendo enviado aos clientes.
* **Verifique seu fluxo de trabalho de fulfillment.** Se você usa serviços externos de fulfillment, certifique-se de que esse flow de captura de pagamento não acione o fulfillment antes que você esteja pronto. Para mais detalhes, consulte nossa [documentação de Fulfillment](/pt/aftersell/fulfillment).
* **Revise suas configurações de retenção de pedidos.** Se você já teve pedidos enviados sem o pagamento concluído, confirme que suas configurações de retenção de pedidos estão configuradas para impedir o fulfillment até que o pagamento seja totalmente capturado.
***
## Resumo
| Situação | Causa | Correção |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| Pico repentino de pedidos Parcialmente pagos em upsells pós-compra (com ou sem app de fraudes) | A Shopify atualizou o modelo de automação "Capture payment if order is not high fraud risk" por volta de 31 de março de 2026, mudando como a análise de fraude é executada em edições de pedidos | Crie o Shopify Flow "Aftersell Post Purchase Offer Accepted" |
| App de detecção de fraudes (por exemplo, Riskified, NoFraud) captura o pagamento cedo demais, ou clientes recebendo produtos gratuitos de upsells com falha | O app de fraudes captura o pagamento original antes de o upsell ser adicionado, ou interfere no timing da limpeza de itens | Crie o Shopify Flow "Order transaction created" da seção de captura manual acima |
| Clientes estão recebendo e-mails de fatura após aceitar um upsell pós-compra | O Shopify Flow pode incluir uma condição de presentment money para a qual a Shopify está retornando dados incorretos | Remova a condição de presentment money do flow (mantenha apenas a condição "Order capturable") |
| Você não está na captura manual de pagamento | Problema diferente — este artigo não se aplica | Consulte [Pedidos parcialmente pagos](/pt/aftersell/partially_paid_orders) para outras causas |
***
## Perguntas frequentes
### Não uso um app de fraudes. Por que os pagamentos dos meus upsells pós-compra não estão sendo capturados?
A Shopify atualizou seu modelo de automação integrado "Capture payment if order is not high fraud risk" por volta de 31 de março de 2026. Antes, a Shopify reexecutava a análise de fraude quando um pedido era editado (como quando um upsell pós-compra era adicionado), o que reacionava o flow de captura de pagamento. A Shopify não faz mais isso, então o pagamento do upsell não é capturado. Criar o Shopify Flow "Aftersell Post Purchase Offer Accepted" descrito acima resolverá esse problema.
### O novo flow capturará o valor total do pedido ou apenas o valor do upsell?
O flow captura apenas o valor pendente do upsell. Ele não captura novamente nem duplica a captura do pagamento do pedido original.
### O que acontece se o pedido não estiver capturável quando o flow for executado?
O flow verifica primeiro a condição "Order capturable". Se o pedido já estiver capturável, ele captura imediatamente.
Se não estiver, o modelo do Aftersell não desiste de imediato: ele aguarda **60 segundos**, verifica `Order capturable` uma segunda vez e captura se o pedido tiver se tornado capturável nesse intervalo. Somente se ainda não estiver capturável a execução termina, com a mensagem **"Order did not become capturable in time"** — em nenhum dos casos a captura é tentada cedo demais.
Um flow construído manualmente com apenas a condição única para na primeira verificação, em vez de tentar novamente.
### Já tenho uma automação da Shopify para capturar pagamentos. Preciso alterá-la?
Não. Sua automação existente da Shopify (como "Capture payment if order is not high fraud risk") pode permanecer como está. O novo Shopify Flow é executado em paralelo e cuida especificamente da lacuna de pagamento do upsell pós-compra.
### Meus clientes estão recebendo e-mails de fatura após aceitar um upsell pós-compra. O que está acontecendo?
Isso pode acontecer se o Shopify Flow incluir uma condição de valor de presentment money. Às vezes, a Shopify retorna o valor de presentment money como 0 mesmo quando há um saldo pendente. Quando isso acontece, o flow pula a captura de pagamento e a Shopify envia um e-mail de fatura ao cliente. A correção é remover a condição de presentment money do flow e manter apenas a verificação "Order capturable".
### Uso Riskified / NoFraud e meus clientes estão recebendo produtos gratuitos de upsells. O que está acontecendo?
Quando um cliente aceita um upsell pós-compra, mas a autorização do pagamento do upsell falha, o Aftersell deve remover o item não pago do pedido após um período definido (configurado em Aftersell > Settings > Fulfillment and Payment > Partially Paid). No entanto, se o seu app de fraudes capturar o pagamento original em um ponto específico da sequência, ele pode interferir na lógica de limpeza do Aftersell, fazendo com que o item não pago permaneça no pedido e seja enviado gratuitamente. A correção com o Shopify Flow acima ajudará ao garantir que o pagamento seja capturado prontamente. Você também deve revisar suas configurações de remoção automática de Parcialmente pagos e suas configurações de retenção de pedidos para impedir o fulfillment antes da confirmação do pagamento.
### O Aftersell participa da captura de pagamento?
Não. O Aftersell não participa da autorização nem da captura de pagamento. O Aftersell instrui a Shopify a adicionar o produto de upsell ao pedido por meio da API pós-compra da Shopify. A Shopify cuida do restante do processo de pagamento. Os Shopify Flows descritos neste artigo são a forma recomendada de garantir que o pagamento seja capturado.
### Onde posso saber mais sobre pedidos parcialmente pagos?
Consulte nosso artigo [Pedidos parcialmente pagos](/pt/aftersell/partially_paid_orders) para detalhes sobre o que causa pedidos parcialmente pagos e como resolvê-los.