Preparar os sistemas para o Shop Cash

Antes de lançar os fluxos de trabalho do Shop Cash com sistemas de terceiros, confirme os seguintes requisitos:

• Os sistemas de ERP, OMS, processamento de pedidos, contabilidade e devolução conseguem aceitar mais de uma forma de pagamento em um único pedido.
• O shop_cash está mapeado como uma forma de pagamento em que os valores de gateway estão disponíveis.
• O Shop Cash não é tratado como desconto, cartão-presente ou crédito na loja.
• O valor de autorização é armazenado como uma string de comprimento variável opaca com pelo menos 1.024 caracteres. Se possível, use um campo de texto ilimitado.
• Capturas, anulações e reembolsos são identificados pela ID da transação em vez do valor de autorização. As operações de captura e anulação da Admin API usam parentTransactionId, e as operações de reembolso usam parentId.
• Os sistemas não analisam, decodificam, normalizam, transformam em hash ou truncam os valores de autorização do Shop Cash.
• Os sistemas conseguem lidar com pagamentos agrupados, nos quais uma linha shop_cash_credit pode representar vários pedidos.
• O fluxo de trabalho de conciliação não presume que um pedido equivale a uma única linha de pagamento.
• O fluxo de trabalho de conciliação consegue lidar com a liquidação da parte do Shop Cash e da parte do cartão ou do Parcelamento do Shop Pay em pagamentos diferentes.
• O fluxo de trabalho de devolução consegue processar reembolsos parciais entre o cartão ou o Parcelamento do Shop Pay e o Shop Cash.
• Os apps de reembolso conseguem reembolsar a transação de captura do Shop Cash, não a transação de autorização.
• Se você veiculou Shop Campaigns antes de janeiro de 2026, seu fluxo de trabalho financeiro processa a linha histórica shop_cash_campaign_billing_debit e as linhas de faturamento da campanha relacionadas de forma separada da receita de pedidos. A partir de janeiro de 2026, os custos da campanha serão lançados na fatura da Shopify.

Os testes do Shop Cash têm limitações porque o recurso depende de contas de comprador do Shop, saldos do Shop Cash, do Shopify Payments e da infraestrutura de liquidação do Shop Cash.

A maneira mais confiável de validar uma integração empresarial de ponta a ponta é fazer um pedido de produção de baixo valor pelo Shop e depois reembolsá-lo. Isso cria transações de pedido como em produção, dados de captura, atividade de pagamento, transações de reembolso e atividade de débito de reembolso que fluem pelo admin da Shopify, dados da Admin API, exportações de pagamentos e dados da API de pagamentos.

As lojas de desenvolvimento podem ajudar a validar alguns formatos de campo de API e lógicas de mapeamento, mas não testam de forma confiável o fluxo completo de checkout originado no Shop, saldo do comprador e liquidação. O modo de teste e o gateway Bogus não criam linhas de pagamento do Shop Cash como na produção porque não usam um fluxo ativo de liquidação do Shopify Payments.

Geralmente, é possível testar os seguintes fluxos de trabalho com um pedido de produção de baixo valor iniciado no Shop:

• Ingestão de pedidos com várias formas de pagamento, incluindo Shop Cash e Shop Pay ou Parcelamento do Shop Pay.
• Mapeamento de ERP ou OMS para shop_cash.
• Armazenamento do valor completo de autorização do Shop Cash.
• Reembolsos parciais e integrais do pedido.
• Ingestão da atividade de pagamento de shop_cash_refund_debit.
• Conciliação de pagamentos para créditos do Shop Cash.
• Comportamento de pré-venda ou captura no processamento de pedidos, caso a loja use a captura posterior.
• Tratamento de apps de devolução para pedidos com mais de uma forma de pagamento.

Ao testar em produção, use um pedido de baixo valor e siga os procedimentos internos de pedido de teste e reembolso da loja.

Entre em contato com o Suporte da Shopify se precisar de ajuda com algum dos cenários a seguir:

• Análise da disponibilidade do Shop Cash para um mercado em implementação.
• Investigação de falha na captura ou no reembolso do Shop Cash.
• Investigação da falta de uma transação de pagamento do Shop Cash após a cadência de pagamento normal mais um ciclo de pagamento adicional.
• Análise para verificar se uma autorização anulada ou expirada do Shop Cash pode ser autorizada novamente.
• Planejamento de lançamento para um fluxo de trabalho complexo de ERP, OMS, pré-venda ou processamento de pedidos.

Antes de escalar o volume de pedidos do Shop Cash, conclua as seguintes verificações:

• O mapeamento da forma de pagamento de ERP e OMS foi implementado e verificado para shop_cash.
• Um pedido de amostra do Shop Cash é ingerido de ponta a ponta, incluindo transações de autorização e captura.
• Um crédito de pagamento de amostra do Shop Cash é conciliado com o pedido ou os pedidos de origem.
• Um reembolso de amostra do Shop Cash é processado e conciliado com o débito de reembolso.
• O sistema aceita linhas agrupadas de pagamento do Shop Cash ou conta com um processo manual de conciliação.
• As equipes de atendimento e finanças compreendem a alocação do reembolso parcial.
• O comportamento de pré-venda, captura manual e captura no processamento de pedidos é validado, se aplicável.
• Os apps de devolução conseguem identificar e reembolsar a transação correta de captura do Shop Cash.
• As equipes de atendimento e finanças conhecem a diferença entre o saldo do Shop Cash do cliente, ofertas do Shop e a atividade de faturamento do Shop Campaigns.

Para requisitos de API e dados de pedidos, consulte Dados de pedidos do Shop Cash e integrações de terceiros. Para requisitos de pagamento, consulte Conciliação de pagamentos do Shop Cash.