> ## 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 manual de pagamento
> Corrija pedidos de upsell pós-compra parcialmente pagos na captura manual de pagamento instalando o modelo do Shopify Flow do Aftersell em poucos cliques.
Se a sua loja usa a captura manual de pagamento, alguns pedidos com um upsell pós-compra aceito podem aparecer como **Parcialmente pago**: o pagamento original é capturado, mas o pagamento do upsell é apenas autorizado. Desde cerca de 31 de março de 2026, isso geralmente é causado por uma mudança de automação da Shopify. Este artigo explica o que mudou e como corrigir o problema com o modelo do Shopify Flow do Aftersell, mantendo suas configurações de captura manual de pagamento.
Está usando um app de detecção de fraudes como **NoFraud** ou **Riskified** que captura o pagamento antes de o upsell ser adicionado, ou vê clientes recebendo produtos gratuitos de upsells com falha? Consulte [Captura de pagamento com apps de detecção de fraudes](/pt/aftersell/fraud-detection-payment-capture).
## Confirme suas configurações de captura de pagamento
Este artigo se aplica apenas a lojas que usam a captura manual 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. Confirme as configurações de captura de pagamento da sua loja em:
**Shopify Admin > Settings > Payments > Payment Capture Method**
Se você não está na captura manual de pagamento, o restante deste artigo não se aplica a você. Consulte [Pedidos parcialmente pagos](/pt/aftersell/partially_paid_orders) para outras causas.
## 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
## Instale o modelo de Flow do Aftersell
O Aftersell publica um modelo pré-construído do Shopify Flow que configura o fluxo de trabalho completo para você com um único clique. Recomendamos usar o modelo em vez de construir o flow manualmente.
No Shopify Admin, acesse **Apps > Flow** e abra a biblioteca de **Templates**.
Procure por **"Capture payment when a post-purchase upsell is accepted"** (listado na categoria **Orders**) e selecione-o.
Clique em **Install workflow**, revise as etapas e ative o fluxo de trabalho. Nenhuma configuração adicional é necessária.
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.
## Como o modelo funciona
1. **Gatilho: "Aftersell Post Purchase Offer Accepted".** O flow começa 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".** O flow verifica se a Shopify consegue capturar o pagamento do pedido naquele momento.
* **Se for verdadeira**, o flow executa **Capture payment** e captura o valor pendente do upsell.
* **Se for falsa**, o flow passa para a próxima etapa.
3. **Espera: 60 segundos.** Às vezes, a Shopify precisa de um momento antes que o pagamento do upsell possa ser capturado, por isso o flow aguarda um minuto antes de tentar novamente.
4. **Condição: "Order capturable is equal to true".** O flow verifica uma segunda vez.
* **Se for verdadeira**, o flow executa **Capture payment**.
* **Se for falsa**, o flow executa **Fail workflow run**. A Shopify ainda não consegue capturar o pagamento, então a execução é marcada como falha no Shopify Flow para que você a revise.
Verifique o histórico de execuções do Shopify Flow em busca de execuções com falha. Uma execução com falha significa que o pagamento do upsell não foi capturado automaticamente e que o pedido pode precisar de revisão manual.
**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. Use o modelo como fornecido, que apenas verifica se o pedido é capturável.
Se não puder usar o modelo, crie um novo fluxo de trabalho no Shopify Flow com estas etapas:
1. Adicione o gatilho **Aftersell Post Purchase Offer Accepted**.
2. Adicione uma **Condition**: **Order capturable is equal to true**.
3. No ramo **True**, adicione a ação **Capture payment**.
4. No ramo **False**, adicione uma ação **Wait** definida para **60 segundos**.
5. Após a espera, adicione uma segunda **Condition**: **Order capturable is equal to true**.
6. No ramo **True** da segunda condição, adicione a ação **Capture payment**.
7. No ramo **False** da segunda condição, adicione a ação **Fail workflow run**.
8. Ative o fluxo de trabalho.
## 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.
## Perguntas frequentes
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. O Shopify Flow descrito neste artigo é a forma recomendada de garantir que o pagamento seja capturado.
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 e não reexecuta mais a análise de fraude quando um pedido é editado. Como resultado, o pagamento do upsell não é capturado. Instale o [modelo de Flow do Aftersell](#install-the-aftersell-flow-template) para corrigir isso.
O flow captura apenas o valor pendente do upsell. Ele não captura novamente nem duplica a captura do pagamento do pedido original.
O modelo do Aftersell verifica primeiro **Order capturable** e captura o pagamento imediatamente se o pedido estiver capturável.
Se não estiver, o modelo aguarda **60 segundos**, verifica **Order capturable** uma segunda vez e captura o pagamento se o pedido tiver se tornado capturável nesse intervalo. Se o pedido ainda não estiver capturável, a execução termina com a mensagem **"Order did not become capturable in time"**. Em nenhum dos casos o pagamento é capturado cedo demais.
Um flow construído manualmente com apenas uma condição (sem espera e nova tentativa) para na primeira verificação, em vez de tentar novamente.
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.
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. Remova a condição de presentment money do flow e mantenha apenas a verificação "Order capturable".
Consulte nosso artigo [Pedidos parcialmente pagos](/pt/aftersell/partially_paid_orders) para detalhes sobre o que causa pedidos parcialmente pagos e como resolvê-los.