Pular para o conteúdo

Criadores, infoprodutos e checkouts

Doze checkouts, doze nomes para a mesma venda

Quinze plataformas de pagamento nomeiam compra, reembolso e assinatura de jeitos incompatíveis, e nenhum padrão aberto resolve.

Nas quinze plataformas de pagamento cuja documentação pública o portal abriu em 23 de agosto de 2026, o fato "compra aprovada" chega com doze nomes literais, de PURCHASE_APPROVED a orders/paid. Chargeback não existe em quatro delas, e apenas cinco dão nome próprio à renovação de assinatura. A Leadlovers publica três números de integração, 18, 12 e 5, que medem coisas diferentes, e só a Hotmart alimenta os cinco baldes de ação do seu motor de automação. Nenhum padrão aberto consultado na mesma data, de schema.org a Meta Conversions API, nomeia chargeback, renovação ou atraso. Quem liga mais de um checkout herda um dicionário por checkout porque o dicionário neutro ainda não foi escrito, e a decisão desta página é escrevê-lo antes da segunda integração.

17 minutos de leitura Revisão em Brasil GEO, responsável editorial

Três números de integrações, e cada um mede outra coisa

A pergunta "com quantos checkouts a Leadlovers se integra" recebe três respostas da própria Leadlovers, e nenhuma delas diz catorze. A página institucional mostra 18 cartões na categoria de pagamento, sob o rótulo "Algumas de nossas integrações". A Central de Ajuda tem tutorial próprio para 12 checkouts e gateways. O motor de automação reconhece 5 baldes de evento. Os três números foram lidos em página viva em 23 de agosto de 2026, e os três estão corretos, porque medem coisas diferentes.

Os 18 cartões incluem Sympla e Eventbrite, que são bilheteria, Kobana, que é boleto, e Vindi e iugu, que são recorrência. A própria página divide a lista entre "Pagamento", com 10 cartões, e "Pagamentos", com 8, duas grafias para uma categoria só. O rótulo "Algumas" avisa que a lista não é exaustiva, e o conteúdo mostra que ela também não é uma lista de checkouts.

Os três números que a Leadlovers publica sobre integrações de pagamento

  • 18 cartões na página institucional

    Rotulada "Algumas de nossas integrações", com 88 cartões no total.

    • Eduzz, Stripe, Monetizze, Hotmart, PayPal, PagSeguro, Braip, Asaas, Digital Manager Guru, Eventbrite, iugu, Kobana, Mercado Pago, Moip, Pagar.me, Sympla, Vindi, Kiwify: dezoito nomes.
    • Duas são bilheteria, uma é boleto, duas são recorrência. A categoria aparece como "Pagamento" e como "Pagamentos".
  • 12 tutoriais na Central de Ajuda

    Checkouts e gateways com passo a passo próprio, apurados no sitemap de 470 URLs.

    • Braip, Mercado Pago, Eduzz, PayT, PagSeguro, Doppus, Hotmart, Stripe, Digital Manager Guru, PayPal, Kiwify, Monetizze: doze checkouts.
    • O índice traz ainda MemberKit, que é área de membros. A lista canônica de provedores fica dentro do aplicativo, atrás de login.
  • 5 baldes no motor de automação

    Os fatos de venda que disparam ação sobre o contato.

    • Pós-venda, cobrança por boleto, pagamento atrasado, cancelamento e abandono de carrinho.
    • Cada balde tem a própria lista de plataformas habilitadas, e só a Hotmart aparece nas cinco.
Contagem do portal sobre a página institucional de integrações, o índice da Central de Ajuda e o artigo de ações automatizadas da Leadlovers, todos abertos em 23 de agosto de 2026.

O artigo "Como usar um Produto de Integração" remete à relação completa de provedores com a frase "Veja a lista dos provedores disponíves aqui," e a frase termina em vírgula, sem link. O texto de abertura dos tutoriais confirma a natureza aberta da lista: "é preciso que você já tenha um produto criado em algum site de pagamento [Monetizze / eduzz / hotmart / pagseguro entre outros.]". Para quem compra, isso significa que o número 12 é um piso documentado, e o número 18 é uma vitrine.

O terceiro número é o que importa para quem automatiza. O motor reconhece cinco fatos: pós-venda, cobrança por boleto, pagamento atrasado, cancelamento e abandono de carrinho. O artigo de ações automatizadas, publicado em 8 de junho de 2026 e atualizado em 13 de julho de 2026, lista a cada balde as plataformas que o alimentam, e as listas não coincidem entre si.

Quantas plataformas alimentam cada balde de ação da Leadlovers

Plataformas habilitadas, de 12 com tutorial

  • Pós-vendaHotmart, Monetizze, Kiwify e PagSeguro 4
  • Cobrança por boletoHotmart, Monetizze, Kiwify e PagSeguro 4
  • CancelamentoHotmart, Monetizze, Digital Manager e Braip 4
  • Abandono de carrinhoHotmart, PayT e Doppus 3
  • Pagamento atrasadoHotmart 1
Contagem do portal sobre o artigo "Como configurar ações automatizadas" da Central de Ajuda da Leadlovers, aberto em 23 de agosto de 2026, que nomeia as plataformas habilitadas em cada balde.

Só a Hotmart está nas cinco listas. As quatro do cancelamento (Hotmart, Monetizze, Digital Manager e Braip) são outras quatro que as do pós-venda (Hotmart, Monetizze, Kiwify e PagSeguro).

Pagamento atrasado existe para uma plataforma de doze

A Central de Ajuda escreve, no balde de atraso: "Pagamento atrasado: Em caso de atraso, aplique ações ao contato para fazer a cobrança. Meios de pagamentos habilitados: Hotmart". No balde de abandono: "Abandono de carrinho … Meios de pagamentos habilitados: Hotmart, PayT e Doppus." Outra página da mesma Central resume a regra: "Algumas ações não estão disponíveis para todas as plataformas de pagamento".

Em termos de operação: uma régua de cobrança por atraso, desenhada no motor da Leadlovers, só dispara para vendas da Hotmart. Uma operação em Kiwify e PagSeguro recebe pós-venda e boleto, e fica sem cancelamento. Uma operação na Braip recebe cancelamento e fica sem boleto. Uma operação na PayT só tem abandono.

O denominador comum dos cinco baldes é uma plataforma. Esse é o número que arde, e ele vem de página pública da própria Leadlovers.

O mesmo fato muda de nome dentro da própria Central de Ajuda

O problema de vocabulário aparece antes de qualquer plataforma externa. A ação "Cobrança por boleto" existe para as integrações externas. No checkout nativo da Leadlovers, o balde equivalente se chama "Ações para cobrança por Pix", com a instrução: "Configure ações para clientes que geraram código Pix e que ainda não efetuaram o pagamento. Você pode usar as tags [CODIGOPIX], [QRCODEPIXA], [EXPIRAPIX] nos seus e-mails de comunicação. O código pix tem a duração de 24 horas após gerado." O checkout nativo aceita cartão e Pix, então a ausência de boleto é coerente. O fato por trás dos dois nomes é o mesmo, uma cobrança emitida e ainda não paga, e a automação escrita para um balde não se reaproveita no outro.

O relatório de vendas do checkout enxerga dois fatos que o motor de automação não enxerga. A página "Como gerenciar as vendas" informa: "É possível filtrar as assinaturas pelo seguintes itens: Formas de pagamento: PIX e Cartão de crédito; Status: Ativa, Cancelada, Chargeback ou Reembolso." Nenhum dos cinco baldes de ação é reembolso ou chargeback. O painel registra o fato; a régua de automação não consegue reagir a ele.

São três nomes para compra aprovada, "Compra Aprovada", "Compra Efetuada" e "Compra realizada", dentro de uma única Central de Ajuda, e nenhum deles é a string que o webhook envia. Por baixo dos rótulos há três modelos mentais. Na Hotmart e na Braip o usuário escolhe um evento. Na Eduzz a integração é cadastrada como entrega de produto: "Dentro do produto localize a aba Entrega e clique em Adicionar entrega. Clique em Outros. Dentre as opções que irão aparecer, escolha leadlovers." Na Monetizze informa-se a URL de postback, sem escolher evento algum. Evento, entrega e postback único são três desenhos incompatíveis, e a Central documenta os três sem nomeá-los como tais.

A recomendação de congelar a versão 1 do webhook da Hotmart

O tutorial "Como integrar Hotmart e leadlovers" instrui: "Em versão, Indicamos utilizar a versão 1, visto que versão 2 ainda possui algumas inconsistências. Em eventos, escolha a opção Compra Aprovada (caso deseje liberar acesso por emissão do boleto, marque também a opção Aguardando pagamento)." A página não diz quais são as inconsistências.

A documentação pública da Hotmart aberta em 23 de agosto de 2026 descreve a versão 2.0.0 do webhook, com nove eventos de compra e um enum de dezessete status. A instrução da Leadlovers protege o usuário de um comportamento que a equipe de suporte observou, e o custo dessa proteção é um dicionário congelado numa versão que o emissor já não apresenta como a atual.

Este registro é retrato do problema, e o problema é de mercado. A mesma página que recomenda a versão antiga é a que documenta, com mais cuidado que a maioria, o que cada evento faz.

Compra aprovada tem doze nomes em quinze plataformas

Fora da Leadlovers a divergência cresce. O portal abriu, em 23 de agosto de 2026, a documentação pública de webhook de quinze plataformas: Hotmart, Eduzz, Kiwify, Cakto, Monetizze, Ticto, PerfectPay, Greenn, Stripe, Shopify, Pagar.me, Nuvemshop, Yampi, Asaas, iugu. A Braip ficou de fora: braip.com, ajuda.braip.com e ev.braip.com devolveram bloqueio ("Sorry, you have been blocked"), docs.braip.com pede senha e a documentação fica dentro do painel, em Ferramentas, Postback, Documentação. A Vindi ficou de fora porque a documentação exige chave de API. As duas entram nesta página como não verificáveis, e a marca "não existe" fica reservada a documentação aberta e lida.

O fato mais simples do ciclo, a compra aprovada, recebe doze nomes literais nas quinze: PURCHASE_APPROVED, myeduzz.invoice_paid, order_approved, purchase_approved, o código 2, authorized, paid, payment_intent.succeeded, orders/paid, order.paid, order/paid e o par PAYMENT_CONFIRMED com PAYMENT_RECEIVED. Três sintaxes convivem, o ponto, a barra com plural e a barra com singular, e "cancelado" se escreve cancelled em umas e canceled em outras.

Quinze plataformas, seis sintaxes para dizer "pago"

  • 4 prefixo com ponto (Eduzz, Stripe, Pagar.me, Yampi) 26,7% do total
  • 3 palavra solta (Ticto, Greenn, iugu) 20% do total
  • 2 MAIÚSCULA_COM_SUBLINHADO (Hotmart, Asaas) 13,3% do total
  • 2 minúscula_com_sublinhado (Kiwify, Cakto) 13,3% do total
  • 2 recurso/verbo com barra (Shopify, Nuvemshop) 13,3% do total
  • 2 código numérico (Monetizze, PerfectPay) 13,3% do total
Agrupamento do portal sobre o nome literal de compra aprovada em cada uma das quinze documentações públicas abertas em 23 de agosto de 2026. A iugu entra pelo valor do campo de status, porque não tem evento próprio de aprovação.
Nome literal que cada plataforma dá a quatro fatos da venda, copiado da documentação pública de webhook aberta em 23 de agosto de 2026. "Não existe" significa que o evento não consta do enum publicado; "campo" significa que o fato chega como valor de um campo, sem evento próprio.
PlataformaCompra aprovadaChargebackAssinatura renovadaCarrinho abandonado
Hotmart (webhook 2.0.0)PURCHASE_APPROVEDPURCHASE_CHARGEBACKNão existe; só o campo recurrence_numberPURCHASE_OUT_OF_SHOPPING_CART
Eduzzmyeduzz.invoice_paidinvoice_chargebackNão existeinvoice_recovering
Kiwify (assina e recebe)compra_aprovada, chega order_approvedchargebacksubscription_renewedcarrinho_abandonado, chega sem campo de evento
Caktopurchase_approvedchargebacksubscription_renewedcheckout_abandonment
Monetizzecódigo 2 Finalizada/AprovadaNão existecódigo 101, o mesmo de assinatura criadacódigo 7 Abandono de Checkout
Ticto v2 (v1)authorized (paid)chargebackextendedabandoned_cart
PerfectPaycódigo 2 approvedcódigo 9 charged_backNão existecódigo 12 precheckout
GreennpaidchargedbackNão existecheckoutAbandoned
Stripepayment_intent.succeededcharge.dispute.createdNão existe; invoice.paid com billing_reasonNão existe
Shopifyorders/paiddisputes/create, só Shopify Paymentssubscription_billing_attempts/successNão existe
Pagar.meorder.paidNão existeNão existecheckout.canceled, que significa link expirado
Nuvemshoporder/paidNão existeNão existeNão existe
Yampiorder.paidNão existeNão existecart.reminder
AsaasPAYMENT_CONFIRMED e PAYMENT_RECEIVEDPAYMENT_CHARGEBACK_REQUESTEDNão existeNão existe
iugucampo status = paidcampo status = chargebacksubscription.renewedNão existe

A leitura por coluna diz mais que a leitura por linha. A coluna de compra aprovada está cheia, com quinze entradas e doze nomes. A coluna de chargeback tem quatro buracos. A coluna de renovação tem cinco nomes próprios, um código compartilhado e nove ausências. Quem integra só a primeira coluna acha que o problema é de tradução; quem precisa das outras descobre que o problema é de existência.

A divergência de existência pesa mais que a de nome

Nome diferente se resolve com uma tabela de tradução. Evento que não existe não se resolve: a automação que depende dele fica muda para aquela plataforma, e ninguém recebe aviso. Contadas sobre a documentação das quinze, as ausências se concentram na segunda metade do ciclo, depois do dinheiro entrar.

Quantas das quinze plataformas dão nome a cada fato da venda

Plataformas, de 15

  • Compra aprovada 15
  • Reembolsofaltam Nuvemshop e Yampi 13
  • Boleto ou Pix geradofaltam Shopify, Yampi e iugu 12
  • Assinatura canceladafaltam Nuvemshop, Yampi e iugu 12
  • Chargebackfaltam Monetizze, Pagar.me, Nuvemshop e Yampi 11
  • Compra recusadafaltam Hotmart, Eduzz, Shopify, Nuvemshop e iugu 10
  • Carrinho abandonadofaltam Stripe, Shopify, Nuvemshop, Asaas e iugu 9
  • Assinatura criadafaltam Hotmart, Kiwify, Ticto, PerfectPay, Greenn, Nuvemshop e Yampi 8
  • Atrasofaltam Eduzz, Stripe, Pagar.me, Nuvemshop, Yampi e iugu 8
  • Assinatura renovadaKiwify, Cakto, Ticto, Shopify e iugu 5
Contagem do portal sobre a documentação pública de webhook das quinze plataformas abertas em 23 de agosto de 2026. Conta como "dá nome" o evento próprio ou o valor literal de um campo de status; Braip e Vindi não entram na base por documentação inacessível.

Carrinho abandonado exclui a Pagar.me, cujo checkout.canceled significa link expirado. Atraso exclui a PerfectPay, cuja tabela de códigos dá dois significados ao código 4. Renovação conta só nome próprio; Monetizze usa o código 101 para criada e renovada.

O chargeback é o caso mais custoso, porque é o fato que mais pesa na conta do produtor e o que menos plataformas nomeiam. A Monetizze publica 17 códigos de evento e nenhum é chargeback. A Pagar.me publica 40 eventos e o chargeback não aparece na página de webhooks nem na de cobrança. A Yampi devolve zero ocorrências para "refund", "estorn" e "chargeback" no texto inteiro da documentação. A Nuvemshop tem nove eventos de pedido e nenhum de reembolso, chargeback ou recusa. Quem vende por essas quatro e quer reagir a um chargeback precisa de outro canal, e o webhook não vai avisar.

A compra recusada tem uma ausência mais sutil. A Hotmart não tem evento de recusa, só o campo purchase.payment.refusal_reason dentro de outro evento. A Shopify faz sucesso, falha e erro trafegarem no mesmo order_transactions/create, que, pela documentação, "Only occurs for transactions with a status of success, failure or error." Para saber que a venda foi recusada, o integrador lê um campo, e o nome do evento não diz nada.

Onde o nome muda ao longo de uma venda

  1. 1 Checkout aberto

    Cakto initiate_checkout, Asaas PAYMENT_CHECKOUT_VIEWED. A maioria não emite nada aqui.

  2. 2 Aguardando pagamento

    12 de 15 nomeiam: PURCHASE_BILLET_PRINTED só para boleto, pix_gerado na Kiwify e na Cakto, código 1 na Monetizze.

  3. 3 Compra aprovada

    15 de 15 nomeiam, com 12 nomes. O Asaas separa PAYMENT_CONFIRMED de PAYMENT_RECEIVED.

  4. 4 Reembolso ou chargeback

    Reembolso em 13 de 15; chargeback em 11. A PerfectPay manda disputa MED com o código 7 de reembolso.

  5. 5 Renovação

    5 de 15 dão nome. Na Stripe é invoice.paid, separado da primeira compra só por billing_reason.

  6. 6 Atraso ou cancelamento

    Atraso em 8 de 15. Na Stripe, invoice.payment_failed cobre recusa e atraso no mesmo nome.

Ciclo de uma venda com os nomes literais da documentação pública de Hotmart, Kiwify, Stripe, Monetizze e Asaas, abertos em 23 de agosto de 2026, e a contagem do portal de quantas das quinze plataformas nomeiam cada etapa.

A figura explica por que a Leadlovers só consegue alimentar o balde de atraso com a Hotmart. O balde depende de um evento que oito das quinze plataformas emitem com nome próprio, e a Hotmart é a única entre as doze com tutorial que o emite como evento de compra, PURCHASE_DELAYED. A restrição do motor espelha a restrição dos emissores.

Sete jeitos de dois dicionários discordarem

Ao ler as quinze documentações lado a lado, as divergências caem em sete tipos, e cada tipo exige um conserto diferente. Os dois primeiros se resolvem com tradução. Os cinco seguintes exigem regra de negócio, e dois deles só aparecem depois que a automação já mandou a mensagem errada.

Os sete tipos de divergência encontrados pelo portal na documentação pública de webhook das quinze plataformas, aberta em 23 de agosto de 2026, com um exemplo literal para cada tipo.
Tipo de divergênciaExemplo literalO que quebra
Nome diferente para o mesmo fatoCompra aprovada é PURCHASE_APPROVED, order_approved, authorized, paid, código 2Nada, se houver tabela de tradução. Tudo, se o mapeamento for feito por string.
Mesmo nome com significado diferenteorder.paid é pedido de loja quitado na Shopify, agregador de cobranças sem carrinho na Pagar.me e "Pedido aprovado" na YampiA mesma regra lê três objetos diferentes e acha que são um.
Evento que só existe numaChargeback não existe em Monetizze, Pagar.me, Nuvemshop e Yampi; recusa não existe em Hotmart, Eduzz, Shopify, Nuvemshop e iuguA automação fica muda para aquela plataforma, sem aviso.
Dois dicionários na mesma plataformaKiwify assina compra_aprovada e recebe order_approved; Ticto usa paid na v1 e authorized na v2O integrador casa o nome que escolheu no painel e nunca recebe.
Colisão de significados num nome sóinvoice.payment_failed na Stripe "due to either a declined payment, including soft decline, or to the lack of a stored payment method"O e-mail de cartão recusado chega a quem está em esteira de cobrança.
Normalização escondidaPerfectPay: "No PostBack alguns status são normalizados (8/10/16 -> 2; 11 -> 6; 17 -> 9; 18/19/20 -> 7)"Disputa MED do Banco Central chega com o código de reembolso a pedido.
Erro de grafia que vira contratoHotmart UNDER_ANALISYS, Greenn TRANSACTIOM, Yampi "shippment"Quem corrige a grafia no seu lado para de receber.

O quarto tipo merece ser visto inteiro, porque é o que mais engana quem configura pelo painel. A Kiwify oferece, para assinatura, o enum boleto_gerado, pix_gerado, carrinho_abandonado, compra_recusada, compra_aprovada, compra_reembolsada, chargeback, subscription_canceled, subscription_late e subscription_renewed. O payload que chega traz outro campo, webhook_event_type, com outros valores.

Kiwify: o que se assina e o que chega

  • O que você marca no painel

    Português, com sublinhado, misturado a inglês nos eventos de assinatura.

    • boleto_gerado
    • compra_recusada
    • compra_aprovada
    • compra_reembolsada
    • chargeback
    • carrinho_abandonado
  • O que o seu servidor recebe

    Inglês, e num evento o campo nem é enviado.

    • billet_created
    • order_rejected
    • order_approved
    • order_refunded
    • chargeback
    • "O parâmetro não é enviado no evento Carrinho abandonado."
Enum de assinatura e valores do campo webhook_event_type conforme a documentação pública da Kiwify, aberta em 23 de agosto de 2026.

O mesmo desenho se repete em outras casas de outra forma. A Ticto mantém as versões 1 e 2 vivas: compra aprovada é paid numa e authorized na outra; boleto é billet_printed numa e bank_slip_created na outra. A Cakto mistura os idiomas dentro de um único enum, com purchase_approved ao lado de pix_gerado e openfinance_nubank_gerado. A Hotmart tem v1 e v2, e a Leadlovers recomenda a v1.

A colisão que manda o e-mail errado

Na Stripe, invoice.payment_failed "Occurs whenever an invoice payment attempt fails, due to either a declined payment, including soft decline, or to the lack of a stored payment method." O mesmo nome cobre a primeira tentativa recusada de um cliente novo e a cobrança mensal que falhou para um assinante antigo. A Pagar.me usa o mesmo nome para os mesmos dois casos.

Uma automação que dispara "seu cartão foi recusado, tente outro" nesse evento acerta o cliente novo e erra o assinante, que está numa esteira de cobrança e precisa de outra mensagem, com outro tom e outro prazo. O erro só aparece na resposta do assinante.

Duas outras colisões da mesma família: checkout.closed na Pagar.me "Ocorre sempre que um pedido de checkout encontra-se em processamento ou quando foi pago", dois estados num nome; e checkout.session.completed na Stripe dispara antes de o dinheiro entrar quando o meio é boleto ou Pix.

A normalização escondida tem duas direções. A PerfectPay achata antes de enviar: os códigos 18, 19 e 20, que incluem med e pre_med, chegam ao postback como o código 7 de refunded. Uma disputa aberta no Banco Central e um reembolso pedido pelo cliente viram o mesmo número. O Asaas faz o oposto e separa o que todas as outras fundem: "PAYMENT_CONFIRMED - Cobrança confirmada (pagamento efetuado, porém, o saldo ainda não foi disponibilizado)." e "PAYMENT_RECEIVED - Cobrança recebida. (Valor disponível na conta Asaas)". Um dicionário canônico que chame tudo de "aprovada" joga essa distinção fora.

Os erros de grafia fecham a lista porque viram contrato. O enum de status da Hotmart publica UNDER_ANALISYS. A documentação da Greenn publica o valor TRANSACTIOM para o tipo de produto e se declara atualizada em 9 de novembro de 2021. Quem casa a string precisa copiar o erro, e quem o corrige no próprio código deixa de receber o evento. A Monetizze acrescenta um aviso que vale para todas: "Não garantimos disparo único por evento."

O prazo de reembolso viaja no payload de uma e não existe em outra

Entre os fatos que precisam de nome, o prazo de reembolso é o que mostra melhor a diferença entre o que a lei fixa, o que a plataforma publica e o que o webhook transporta. O Código de Defesa do Consumidor, no art. 49, diz: "O consumidor pode desistir do contrato, no prazo de 7 dias a contar de sua assinatura ou do ato de recebimento do produto ou serviço, sempre que a contratação de fornecimento de produtos e serviços ocorrer fora do estabelecimento comercial". O parágrafo único completa: "os valores eventualmente pagos, a qualquer título, durante o prazo de reflexão, serão devolvidos, de imediato, monetariamente atualizados."

A lei fixa dois prazos distintos, e eles costumam ser confundidos. Sete dias é a janela para desistir. A devolução do dinheiro, depois da desistência, é "de imediato", sem número de dias. Quando uma plataforma publica uma janela de garantia maior que sete dias, ela está ampliando o direito de desistir; quando publica um prazo em dias úteis para o produtor devolver, está regulando o segundo prazo, aquele que a lei não mede em dias.

Janela de reembolso publicada por cada plataforma em 23 de agosto de 2026, conforme as respectivas centrais de ajuda e documentações de webhook. "Não encontrado" significa que o portal não localizou um prazo em dias nas páginas abertas naquela data.
PlataformaJanela publicadaO que a mesma fonte acrescenta
Hotmart7, 15, 21 ou 30 dias, por produto"Para produtos cadastrados como Assinatura, o prazo de garantia escolhido vale apenas para a primeira cobrança"
Kiwify7 dias da data da compra"Esse prazo é contado a partir da data da compra, e não da data em que o reembolso foi solicitado."
Eduzz7 dias do CDC mais até 30 do produtor"O prazo limite para solicitação de reembolso pelo cliente final é de até 75 dias… para PIX ou boleto, e de até 150 dias para cartão de crédito."
Greenn7 dias; o produtor tem 3 dias úteis para devolver"Após a solicitação de reembolso, o produtor possui até 3 dias úteis… Caso não seja efetuado, a Greenn poderá intervir"
TictoDefinido pelo produtor, e viaja no payloadCampo item.refund_deadline no webhook v2. "A partir da 2ª cobrança em diante, o pedido deve ser feito com o produtor."
Leadlovers checkoutSem prazo publicadoCartão pelo suporte de checkout; boleto e Pix "diretamente com o vendedor".
Cakto e MonetizzeNão encontrado em diasNenhuma das duas centrais abertas publica a janela.

A Ticto é a única das quinze que coloca o prazo dentro do webhook, no campo item.refund_deadline. Para as outras, o prazo é um fato que existe na central de ajuda e não existe no payload: a automação que quer avisar o cliente de que a garantia termina amanhã precisa carregar esse número de fora. A Hotmart adiciona uma regra que muda o cálculo em assinaturas, a garantia vale só para a primeira cobrança, e a Ticto publica a mesma regra com outras palavras. Em nenhuma das duas esse limite chega como evento.

Uma assinatura mensal e os nomes que cada marco recebe

  1. Dia 0 Pix gerado e compra aprovada cumprido

    12 de 15 nomeiam o Pix ou boleto gerado; 15 de 15 nomeiam a aprovação, com 12 nomes. O Asaas emite PAYMENT_CONFIRMED e, quando o saldo fica disponível, PAYMENT_RECEIVED.

  2. Dia 7 Fim da janela legal de desistência cumprido

    Prazo do art. 49 do CDC. Só a Ticto carrega o prazo no payload (item.refund_deadline). A Hotmart admite 7, 15, 21 ou 30 dias, válidos apenas para a primeira cobrança da assinatura.

  3. Dia 30 Renovação cobrada em curso

    5 de 15 dão nome próprio: subscription_renewed (Kiwify e Cakto), extended (Ticto), subscription_billing_attempts/success (Shopify), subscription.renewed (iugu). Na Stripe é invoice.paid; na Hotmart, PURCHASE_APPROVED com recurrence_number maior que 1.

  4. Dia 30, cobrança falha Atraso previsto

    8 de 15 nomeiam: PURCHASE_DELAYED, subscription_late, subscription_renewal_refused, subscription_delayed, PAYMENT_OVERDUE. Na Stripe, invoice.payment_failed cobre este caso e a recusa de cliente novo.

  5. Dia 45 Chargeback ou cancelamento previsto

    Chargeback em 11 de 15; cancelamento em 12 de 15. Na Stripe, customer.subscription.deleted também dispara no fim natural do período, e o nome não distingue os dois.

Marcos de uma assinatura mensal hipotética, com os eventos literais da documentação pública de Hotmart, Kiwify, Stripe, Ticto, Asaas e iugu abertos em 23 de agosto de 2026, o art. 49 do CDC e a contagem do portal sobre as quinze plataformas. As datas pertencem ao cenário construído pelo portal.

Reembolso e chargeback são fatos distintos para nove das quinze plataformas, que os separam por evento (Hotmart, Eduzz, Kiwify, Cakto, Ticto, PerfectPay, Greenn, Stripe, Asaas). A Hotmart define a diferença: "O chargeback acontece quando o cliente, sem entrar em contato com a Hotmart ou com o Produtor, solicita o cancelamento da transação diretamente na administradora do cartão… No caso do reembolso, o comprador pode solicitá-lo dentro do prazo de garantia". A Ticto mede a consequência: reembolso "Não impacta o índice de chargeback", e chargeback "Impacta diretamente a taxa". A Kiwify publica o limite: "Se a sua conta tem uma taxa de chargeback acima de 1.5%, a plataforma pode ser obrigada a parar de processar pagamentos para você." Quatro plataformas não têm o evento, e a PerfectPay manda a disputa com o código do reembolso. Para essas cinco, a métrica que pode suspender a conta não chega pelo webhook.

O décimo sexto dicionário não existe em padrão aberto nenhum

A saída natural seria traduzir cada plataforma para um vocabulário neutro que alguém já tivesse publicado. O portal procurou esse vocabulário em cinco candidatos, todos abertos em 23 de agosto de 2026, e nenhum nomeia o ciclo financeiro do checkout. Cada um falha por um motivo diferente, e os motivos explicam por que o problema persiste.

Candidatos a vocabulário neutro de eventos de venda e o motivo pelo qual cada um não cobre o ciclo do checkout, conforme as páginas oficiais abertas pelo portal em 23 de agosto de 2026.
CandidatoValores literaisPor que não serve
schema.org OrderStatusOrderCancelled, OrderDelivered, OrderInTransit, OrderPaymentDue, OrderPickupAvailable, OrderProblem, OrderProcessing, OrderReturnedVocabulário logístico. Sem chargeback, assinatura, renovação ou inadimplência. A própria página informa "Usage: < 1K Domains (Google - July 2026)".
CloudEvents (CNCF)Atributo typePadrão de envelope, sem vocabulário de domínio. A especificação diz do tipo: "The format of this is producer defined". Quem define "pedido pago" continua sendo cada plataforma.
OASIS UBLOrder, InvoiceFaturamento eletrônico entre empresas. Escopo errado.
GA4add_payment_info, begin_checkout, purchase, refund, view_item e mais noveEventos de navegador. O único pós-venda é refund. Sem chargeback, renovação, falha de pagamento ou disputa.
Meta Conversions APIPurchase, Subscribe, StartTrial, InitiateCheckout, Lead e mais dozeTem a entrada da assinatura e nada da saída. A renovação existe só como contexto, no action_source system_generated.

Os dois candidatos de medição merecem uma leitura mais próxima, porque são os que uma equipe de marketing já usa. O GA4 publica catorze eventos recomendados para comércio, e o único que acontece depois do dinheiro entrar é refund. A Meta Conversions API publica Subscribe e StartTrial, e o outro lado do ciclo, a renovação, aparece apenas na descrição do campo action_source, que admite o valor system_generated com o exemplo de "uma renovação de assinatura". A renovação existe como circunstância de um evento e fica sem nome de evento. Um chargeback não tem onde entrar.

O schema.org mostra o outro limite. O vocabulário existe, está publicado e é aberto, e a página registra menos de mil domínios usando OrderStatus, com data de julho de 2026. Ser aberto não o tornou adotado, e os oito valores descrevem a entrega do pedido e param antes do pagamento. O CloudEvents, que é o padrão de envelope mais usado em infraestrutura, delega explicitamente o nome do evento ao produtor. Isso fecha o círculo: o único lugar onde um dicionário neutro poderia nascer decidiu, por especificação, que o nome é de quem emite.

O que esta busca prova e o que ela não prova

A busca prova que nenhum dos cinco candidatos abertos em 23 de agosto de 2026 nomeia chargeback, renovação, falha de cobrança, disputa ou repasse. Um sexto candidato pode existir fora dessa lista; se existe, nenhuma das quinze plataformas o adota, porque nenhum dos doze nomes de compra aprovada vem de um padrão externo.

A consequência para quem integra é a mesma nos dois casos. O dicionário neutro, o décimo sexto, precisa ser escrito por quem liga os checkouts, e vai ser escrito de qualquer jeito: em tabela, antes da segunda integração, ou em condicionais espalhadas pelo código, depois da terceira.

Escreva o dicionário antes de ligar o segundo checkout

A decisão desta página é construir um dicionário próprio de eventos canônicos antes de ligar o segundo checkout, e mapear cada plataforma para ele, registrando por escrito o que ela não emite. A ordem importa: com um checkout só, o dicionário da plataforma serve; com dois, a primeira automação que usa os dois já precisa de uma tradução, e ela costuma nascer dentro de uma regra de automação, onde ninguém a revisa.

Como decidir se um fato vira evento canônico

mesmo significadoSignifica a mesma coisa em todaso nome colide

  • Traduza e registre a ausência

    Chargeback existe em 11 de 15 e significa o mesmo nas 11. Vira evento canônico, e a tabela de mapeamento anota "não emite" para Monetizze, Pagar.me, Nuvemshop e Yampi, com a régua de chargeback desligada nelas por decisão registrada.

  • Traduza direto

    Compra aprovada existe em 15 de 15. Doze nomes viram um só. A única ressalva é o Asaas, que separa confirmado de recebido; o dicionário decide qual dos dois é "aprovada" e anota a escolha.

  • Reconstrua por campo, ou não prometa

    Renovação tem nome próprio em 5 de 15. Onde falta, reconstrua por campo (recurrence_number na Hotmart, billing_reason na Stripe) e documente a regra; onde nem o campo existe, a automação de renovação fica fora da promessa.

  • Desdobre antes de traduzir

    invoice.payment_failed existe na Stripe e na Pagar.me, e significa recusa de cliente novo ou atraso de assinante. O dicionário precisa de dois eventos canônicos, recusada e atrasada, e o mapeamento lê um segundo campo para decidir qual dos dois.

falta em algumaExiste nas plataformas que você usaexiste em todas

Critério de decisão do portal, construído em 23 de agosto de 2026 sobre a contagem de existência e de significado nas quinze documentações públicas verificadas naquela data.
  1. Liste os fatos de venda que a sua operação precisa automatizar, e dê a cada um um nome canônico em português, com definição de uma frase. Os dez acima são o piso; uma operação sem assinatura fica com seis.
  2. Para cada plataforma que você usa, abra a documentação de webhook e preencha uma linha por fato canônico com o nome literal do evento, copiado com o erro de grafia incluído. Onde não houver evento, escreva "não emite", e onde o fato vier por campo, escreva o campo e o valor.
  3. Marque os nomes que colidem: um evento da plataforma que cai em dois fatos canônicos. Para cada colisão, escreva qual campo do payload desempata e o que fazer quando o campo não vem.
  4. Registre a versão do webhook de cada plataforma ao lado do mapeamento. Ticto v1 e v2, Hotmart v1 e v2 e o par assina/recebe da Kiwify são dicionários diferentes, e a tabela precisa dizer qual deles você lê.
  5. Liste, por automação, os fatos canônicos de que ela depende, e cruze com a tabela. Toda automação que depende de um fato marcado "não emite" em alguma plataforma fica com aviso explícito no nome, para que ninguém espere uma régua de chargeback disparar na Monetizze.
  6. Trate o motor da Leadlovers como mais uma linha da tabela. Os cinco baldes são um dicionário de cinco fatos, e a coluna de plataformas habilitadas já vem preenchida pela Central de Ajuda. Pós-venda para quatro, atraso para uma.
  7. Registre a data de consulta ao lado de cada linha. A Greenn publica documentação datada de 9 de novembro de 2021, a Hotmart retém 60 dias de histórico de webhook, e a Leadlovers atualizou a página de ações em 13 de julho de 2026. Dicionário sem data envelhece sem avisar.

O critério, e a recomendação

O critério é o número de checkouts que a mesma automação lê. Com um, use o dicionário da plataforma e registre a versão. Com dois ou mais, o dicionário próprio custa uma tabela de dez linhas por plataforma, e a alternativa custa uma mensagem de cartão recusado enviada a um assinante em cobrança, ou uma régua de chargeback que nunca dispara porque a plataforma não emite o evento.

A recomendação é escrever a tabela antes de ligar o segundo checkout, com a coluna "não emite" preenchida com o mesmo cuidado da coluna de nomes. A ausência é a informação mais cara deste levantamento, porque é a que nenhuma plataforma anuncia: Monetizze publica 17 códigos sem dizer que chargeback falta, e a Leadlovers publica cinco baldes sem somar que só um deles vale para todas as suas integrações.

A taxa dessas mesmas plataformas tem página própria no portal, com a conta de R$ 100 mil por mês em três tickets: O checkout pode custar mais que todo o software. As duas contas se somam: o percentual é o que o checkout cobra, e o dicionário é o que ele deixa de entregar.

Perguntas que aparecem depois desta leitura

Com quantas plataformas de pagamento a Leadlovers se integra?

A própria Leadlovers publica três números, lidos em 23 de agosto de 2026. A página institucional mostra 18 cartões na categoria de pagamento, sob o rótulo "Algumas de nossas integrações", e a lista inclui bilheteria (Sympla, Eventbrite), boleto (Kobana) e gateway de recorrência (Vindi, iugu). A Central de Ajuda tem tutorial para 12 checkouts e gateways. O motor de automação reconhece 5 baldes de evento, e só a Hotmart alimenta os cinco. Nenhuma página publicada diz catorze.

Por que o nome do evento muda de um checkout para outro?

Porque cada plataforma define o próprio vocabulário e nenhum padrão aberto nomeia o ciclo financeiro da venda. Nas quinze documentações abertas pelo portal em 23 de agosto de 2026, compra aprovada tem doze nomes literais, de PURCHASE_APPROVED na Hotmart a orders/paid na Shopify. O CloudEvents, padrão de envelope da CNCF, diz que o formato do tipo de evento é definido pelo produtor, e schema.org, GA4 e Meta Conversions API param antes do chargeback: nenhum dos três nomeia renovação de assinatura, e nenhum nomeia atraso de pagamento.

Quais plataformas não enviam evento de chargeback?

Na documentação pública aberta em 23 de agosto de 2026, Monetizze, Pagar.me, Nuvemshop e Yampi não têm evento de chargeback. A Monetizze publica 17 códigos e a Pagar.me 40 eventos sem ele; a Yampi devolve zero ocorrências para "chargeback" no texto da documentação. A PerfectPay tem o evento, mas normaliza a disputa MED para o código de reembolso antes de enviar. A Braip não entra na contagem porque a documentação está atrás de bloqueio e senha.

O que é um dicionário de eventos canônicos?

Uma tabela própria que dá um nome neutro a cada fato de venda que a operação automatiza, com uma linha por plataforma dizendo qual evento literal corresponde a ele, qual campo desempata colisões e o que a plataforma não emite. O piso proposto nesta página tem dez fatos: compra aprovada, compra recusada, pagamento aguardando, checkout abandonado, reembolso a pedido, contestação no cartão, assinatura criada, assinatura renovada, assinatura cancelada, assinatura atrasada. A recomendação é escrevê-la antes de ligar o segundo checkout.

Qual o prazo legal de reembolso em compra online no Brasil?

O art. 49 do Código de Defesa do Consumidor dá ao consumidor 7 dias para desistir de contrato feito fora do estabelecimento comercial, contados da assinatura ou do recebimento, e determina que os valores pagos sejam devolvidos "de imediato, monetariamente atualizados". A lei fixa a janela de desistência em dias e não fixa a devolução em dias. As plataformas publicam janelas diferentes em 23 de agosto de 2026: Hotmart admite 7, 15, 21 ou 30 dias por produto; Kiwify conta 7 dias da data da compra; Greenn dá 3 dias úteis ao produtor para devolver; Cakto e Monetizze não publicam o prazo em dias.

A versão 1 ou a versão 2 do webhook da Hotmart?

O tutorial da Leadlovers, aberto em 23 de agosto de 2026, recomenda a versão 1 "visto que versão 2 ainda possui algumas inconsistências", sem dizer quais. A documentação pública da Hotmart na mesma data descreve a versão 2.0.0, com nove eventos de compra. Quem segue o tutorial fica com um dicionário congelado e deve registrar a versão escolhida ao lado do mapeamento, porque os nomes das duas versões não coincidem.

De onde vêm os números desta página

Cada dado abaixo tem origem nomeada e data de consulta. Número sem fonte publicada não entra no texto; quando a fonte não publica o valor, a página diz isso na frase.

  1. Leadlovers, página institucional de integrações, com os 18 cartões da categoria de pagamento sob o rótulo "Algumas de nossas integrações" e as duas grafias da categoria. Consulta em 23 de agosto de 2026.
  2. Leadlovers, Central de Ajuda, índice de integrações de pagamento, com os 12 tutoriais de checkout e gateway, apurado pelo sitemap de 470 URLs. Consulta em 23 de agosto de 2026.
  3. Leadlovers, Central de Ajuda, "Como configurar ações automatizadas", publicado em 8 de junho de 2026 e atualizado em 13 de julho de 2026, com os cinco baldes de ação e as plataformas habilitadas em cada um. Consulta em 23 de agosto de 2026.
  4. Leadlovers, Central de Ajuda, "Como configurar ações na sua integração", do checkout nativo, com o balde "Ações para cobrança por Pix" e a duração de 24 horas do código. Consulta em 23 de agosto de 2026.
  5. Leadlovers, Central de Ajuda, "Como gerenciar as vendas", com os filtros de status Ativa, Cancelada, Chargeback ou Reembolso. Consulta em 23 de agosto de 2026.
  6. Leadlovers, Central de Ajuda, "Como integrar Braip e leadlovers", com os rótulos "Boleto Impresso", "Compra Efetuada", "Abandono de Checkout" e "Compra Aprovada". Consulta em 23 de agosto de 2026.
  7. Leadlovers, Central de Ajuda, "Como integrar Hotmart e leadlovers", com a recomendação de usar a versão 1 do webhook e os eventos Compra Aprovada e Aguardando pagamento. Consulta em 23 de agosto de 2026.
  8. Leadlovers, Central de Ajuda, perguntas frequentes do checkout, com a regra de reembolso por meio de pagamento e sem prazo em dias. Consulta em 23 de agosto de 2026.
  9. Hotmart, documentação de desenvolvedores, webhook de compra 2.0.0, com os nove eventos de compra, o enum de status com UNDER_ANALISYS e a retenção de 60 dias. Consulta em 23 de agosto de 2026.
  10. Hotmart, central de ajuda, artigo sobre prazo de garantia, com as janelas de 7, 15, 21 ou 30 dias e a regra da primeira cobrança em assinatura. Consulta em 23 de agosto de 2026.
  11. Hotmart, central de ajuda, artigo sobre a diferença entre chargeback e reembolso. Consulta em 23 de agosto de 2026.
  12. Eduzz, documentação de desenvolvedores, webhook, com os eventos myeduzz.invoice_paid, contract_created e demais. Consulta em 23 de agosto de 2026.
  13. Eduzz, central de ajuda, artigo sobre prazos de reembolso, com os tetos de 75 dias para Pix e boleto e 150 dias para cartão. Consulta em 23 de agosto de 2026.
  14. Kiwify, documentação da API, criação de webhook, com o enum de triggers em português e os valores de webhook_event_type em inglês. Consulta em 23 de agosto de 2026.
  15. Kiwify, central de ajuda, "Como funciona o reembolso na Kiwify", com a contagem de 7 dias a partir da data da compra. Consulta em 23 de agosto de 2026.
  16. Kiwify, central de ajuda, "O que são chargebacks", com o limite de 1.5% de taxa de chargeback. Consulta em 23 de agosto de 2026.
  17. Cakto, documentação, conceitos de webhooks, com os 16 eventos do enum bilíngue. Consulta em 23 de agosto de 2026.
  18. Monetizze, documentação da API, webhook, com os 17 códigos numéricos, a distinção entre os códigos 9 e 4 e o aviso de disparo não único. Consulta em 23 de agosto de 2026.
  19. Ticto, documentação de webhook, versão 2, com os eventos authorized, extended, subscription_delayed e o campo item.refund_deadline. Consulta em 23 de agosto de 2026.
  20. Ticto, documentação de webhook, versão 1, com os eventos paid, billet_printed e chargeback e suas descrições em português. Consulta em 23 de agosto de 2026.
  21. Ticto, central de ajuda, "Chargeback na Ticto", com a distinção entre reembolso e chargeback e o impacto na taxa. Consulta em 23 de agosto de 2026.
  22. PerfectPay, documentação da API em JSON, com os 20 códigos de status e a nota de normalização do postback. Consulta em 23 de agosto de 2026.
  23. Greenn, central de ajuda, documentação do webhook, datada de 9 de novembro de 2021, com os valores de currentStatus e o valor TRANSACTIOM. Consulta em 23 de agosto de 2026.
  24. Greenn, central de ajuda, "Como funciona o reembolso", com o prazo de 3 dias úteis do produtor. Consulta em 23 de agosto de 2026.
  25. Stripe, referência da API, tipos de evento, com as descrições de payment_intent.succeeded, invoice.payment_failed, charge.dispute.created e customer.subscription.deleted. Consulta em 23 de agosto de 2026.
  26. Shopify, documentação da Admin GraphQL API, enum WebhookSubscriptionTopic, com os 214 tópicos e as descrições de orders/paid, refunds/create e order_transactions/create. Consulta em 23 de agosto de 2026.
  27. Pagar.me, documentação de webhooks, com os 40 eventos e as descrições de order.paid, checkout.canceled e checkout.closed. Consulta em 23 de agosto de 2026.
  28. Nuvemshop, documentação da API, recurso webhook, com os nove eventos de pedido. Consulta em 23 de agosto de 2026.
  29. Yampi, documentação da API, introdução a webhooks, com os 14 eventos e as descrições de order.paid e cart.reminder. Consulta em 23 de agosto de 2026.
  30. Asaas, documentação, webhook para cobranças, com os 31 eventos e a distinção entre PAYMENT_CONFIRMED e PAYMENT_RECEIVED. Consulta em 23 de agosto de 2026.
  31. iugu, documentação de desenvolvedores, gatilhos de fatura, com invoice.status_changed e os valores do campo de status. Consulta em 23 de agosto de 2026.
  32. iugu, documentação de desenvolvedores, gatilhos de assinatura, com subscription.created e subscription.renewed. Consulta em 23 de agosto de 2026.
  33. Presidência da República, Lei 8.078 de 1990, Código de Defesa do Consumidor, texto compilado, art. 49 e parágrafo único. Consulta em 23 de agosto de 2026.
  34. schema.org, enumeração OrderStatus, com os oito valores e a nota de uso abaixo de mil domínios em julho de 2026. Consulta em 23 de agosto de 2026.
  35. Google, documentação do GA4, referência de eventos recomendados, com os eventos de comércio e o refund como único pós-venda. Consulta em 23 de agosto de 2026.
  36. Portal Leadlovers 2026, "O checkout pode custar mais que todo o software", com as taxas publicadas das mesmas plataformas sobre R$ 100 mil por mês. Consulta em 23 de agosto de 2026.

Voltar ao topo