Quando você reembolsa ou cancela um pedido na sua loja Shopify, a Shopify avisa o seu MemberArea, e o seu MemberArea atualiza o pedido que criou para essa compra. Este artigo explica o que acontece com o acesso do comprador, o pedido, o seu estoque e a comissão de um afiliado, e onde você pode conferir o resultado. Ele trata das compras que os seus clientes fazem na sua loja.
As duas chaves
Duas chaves decidem se o acesso é retirado. As duas estão ligadas, a menos que você as tenha alterado:
| Chave | O que ela faz |
|---|---|
| Revogar acesso em caso de reembolso | Um reembolso retira o acesso que os itens reembolsados liberaram. |
| Revogar acesso em caso de cancelamento | Um cancelamento retira o acesso que o pedido inteiro liberou. |
Você as encontra na sua página da Shopify em
/admin/settings/integrations/shopify, na aba Regras, que aparece assim
que a sua loja está conectada. Uma alteração é salva na hora. Se o salvamento
falhar, a chave volta à posição anterior e uma mensagem avisa. As mesmas chaves
aparecem também na etapa Regras de Configurar o Shopify, onde são
salvas quando você clica em Concluir a configuração. As chaves valem para a
loja inteira, não para uma única associação, e se aplicam a reembolsos e
cancelamentos que chegam depois que você as altera.

As chaves só decidem sobre o acesso. O pedido, o estoque e a comissão seguem o reembolso ou o cancelamento de qualquer forma.
O que cada evento faz
| Evento na Shopify | Acesso | Pedido | Estoque | Comissão |
|---|---|---|---|---|
| Reembolso total | Retirado, se a chave de reembolso estiver ligada | Reembolsado | Volta | Reduzida pela parte reembolsada |
| Reembolso parcial | Retirado só para itens reembolsados por inteiro, se a chave de reembolso estiver ligada | Parcialmente reembolsado | Inalterado | Reduzida pela parte reembolsada |
| Reembolso de um valor sem itens | Permanece | Parcialmente reembolsado, ou reembolsado se cobrir o pagamento inteiro | Inalterado | Reduzida pela parte reembolsada |
| Cancelamento | Retirado para o pedido inteiro, se a chave de cancelamento estiver ligada | Cancelado, nenhum dinheiro é estornado | Inalterado até o reembolso chegar | Estornada por inteiro |
Estoque aqui significa o estoque dos produtos que controlam estoque no catálogo do seu MemberArea.
Reembolsos totais
Um reembolso conta como total quando todos os itens do pedido são reembolsados na quantidade completa. O seu MemberArea então marca o pedido como reembolsado, devolve o estoque e reduz a comissão pela parte do pagamento que foi reembolsada. Com Revogar acesso em caso de reembolso ligado, o comprador perde o acesso que o pedido liberou.
O acesso que o comprador também pagou em outro pedido permanece. Se o mesmo curso veio com um segundo pedido que continua pago, o membro o mantém.
Reembolsos parciais
Um reembolso parcial lança o valor reembolsado no pagamento do pedido, que passa a contar como parcialmente reembolsado. O acesso só é retirado para um item cuja quantidade inteira foi reembolsada. Se um comprador comprou três vagas de um curso e você reembolsa duas, o acesso permanece, e a nota diz "Partial refund of some units, access stays untouched." Quando a terceira vaga também é reembolsada, o acesso sai.
Um reembolso de um valor sem nenhum item, como um pagamento de cortesia, lança o dinheiro e não mexe no acesso. A nota diz algo como "Refund of 500 cents without line items, access stays untouched."
O estoque só volta quando o pedido inteiro é reembolsado. Um reembolso parcial deixa o estoque como está.
Cancelamentos
Um pedido cancelado é marcado como cancelado. A comissão de afiliado sobre ele é estornada por inteiro, e com Revogar acesso em caso de cancelamento ligado, o comprador perde o acesso que o pedido inteiro liberou. Com a chave desligada, o acesso permanece e a nota diz "Order cancelled, revoking is switched off for this shop."
Um cancelamento não estorna dinheiro. O pagamento do pedido fica como estava, e a lista de pedidos mostra Cancelado. Dinheiro, status de reembolso e estoque só acompanham um reembolso. Quando você cancela um pedido na Shopify e o reembolsa, a Shopify envia o reembolso como uma mensagem separada. Quando esse reembolso cobre o pedido inteiro, o estoque volta e o pedido conta como reembolsado. Um reembolso parcial depois de um cancelamento é lançado como reembolso parcial, e o pedido continua cancelado.
O resultado não depende da ordem em que as mensagens da Shopify chegam. Um pedido reembolsado por inteiro termina como reembolsado; qualquer outro pedido cancelado, como cancelado.
Um reembolso que vem depois de um cancelamento é tratado pela chave de reembolso, Revogar acesso em caso de reembolso. Se você quer que os compradores mantenham o acesso em um cancelamento com reembolso, desligue as duas chaves, não só a de cancelamento.
Comissões de afiliados
Quando um afiliado ganhou uma comissão sobre o pedido, cada reembolso a reduz pela parte do pagamento que você reembolsou. Reembolsar metade do pedido retira metade da comissão. Um cancelamento estorna a comissão inteira, mesmo sem estornar dinheiro. Um reembolso que chega depois do cancelamento não retira a comissão uma segunda vez. Isso funciona da mesma forma com as chaves de acesso ligadas ou desligadas.
Onde você vê o resultado
Abra a sua página da Shopify em /admin/settings/integrations/shopify e
escolha a aba Registro de webhooks. Um reembolso aparece como
refunds/create, um cancelamento como orders/cancelled, cada um com o
resultado Processado e uma nota sobre o que o seu MemberArea fez.

Abra Pagamentos, depois Vendas, depois Pedidos para ver o pedido. O status mostra Reembolsado, Parcialmente reembolsado ou Cancelado, e a coluna Reembolsado mostra o valor. Para um pedido de teste, escolha antes Mostrar pedidos de teste.
Notas no registro de webhooks
| Nota | O que significa |
|---|---|
| "Full refund, access revoked (...)." | O pedido inteiro foi reembolsado. Os parênteses contam o que foi retirado por tipo, ou dizem "nothing to revoke". |
| "Partial refund, access revoked for n item(s) (...)." | Alguns itens foram reembolsados por inteiro, e o acesso deles foi retirado. |
| "Partial refund of some units, access stays untouched." | Só parte da quantidade de um item foi reembolsada. |
| "Refund recorded, the refunded items were not mapped." | O reembolso foi lançado, mas os itens reembolsados não liberavam nada. |
| "Refund recorded, the order has no member to revoke from." | O reembolso foi lançado, mas o pedido não tem membro. |
| "Refund recorded, revoking is switched off for this shop." | O reembolso foi lançado, e Revogar acesso em caso de reembolso está desligado. |
| "Order cancelled, access revoked (...)." | O pedido foi cancelado e o acesso dele foi retirado. |
| "Order cancelled, revoking is switched off for this shop." | O pedido foi cancelado, e Revogar acesso em caso de cancelamento está desligado. |
| "No matching order for this refund." | O seu MemberArea não tem pedido para ele, por exemplo porque foi feito antes de você conectar a loja. |
| "No matching order for this cancellation." | O mesmo para um cancelamento. |
Casos especiais
Cada reembolso é lançado uma vez. Se a Shopify envia o mesmo reembolso de novo, nada é lançado uma segunda vez e a nota diz "This refund was already recorded."
Às vezes a Shopify informa um reembolso enquanto o pedido pago ainda está a caminho. O seu MemberArea então tenta o reembolso de novo um pouco depois, sozinho, quando o pedido já estiver lá. Até lá, a linha pode mostrar Tentando novamente com "The order for this refund has not been imported yet, trying again shortly."
O seu MemberArea lança um reembolso na moeda em que o pedido foi pago. Se a Shopify informa um reembolso sem itens e com um valor só em outra moeda, nada é lançado e a nota diz "Refund in a foreign currency without an amount in the payment currency, nothing booked." Acesso, pedido, estoque e comissão ficam então como estavam. Se a Shopify envia esse reembolso de novo, a nota diz "This refund was already recorded."
Automações
Você pode reagir a reembolsos e cancelamentos com as suas próprias automações. O gatilho Reembolso na Shopify dispara uma vez para cada novo reembolso, também para um reembolso de um valor sem itens e também quando Revogar acesso em caso de reembolso está desligado. Para um reembolso em moeda estrangeira sem valor na moeda do pagamento, ele dispara com o valor 0. O gatilho Pedido cancelado na Shopify dispara uma vez por pedido cancelado, esteja Revogar acesso em caso de cancelamento ligado ou desligado. Se a Shopify envia a mesma mensagem duas vezes, nenhum dos gatilhos dispara uma segunda vez. Como configurar automações para a sua loja está em Enviar eventos de membros de volta para a Shopify.
Retirar o acesso
Remover uma associação não tira nada dos compradores. A confirmação Remover mapeamento diz isso: "Os compradores mantêm o acesso que já pagaram. Novas compras deste produto não desbloqueiam nada." Para retirar o acesso de um comprador, reembolse o pedido na Shopify. Isso funciona para pedidos anteriores mesmo depois que a associação não existe mais.