O que é igual nas seis#
O endpoint (POST /elements/checkout), os campos, o Throne Elements, o formato do webhook transaction.paid e a consulta GET /transactions/{id} são os mesmos nas seis adquirentes. A cobrança é sempre à vista, em uma parcela, na moeda em que você criou a venda, com a cotação do seu saldo fixada na criação.
O que muda é o comportamento do checkout, na tabela abaixo.
Lado a lado#
| Sterling | Imperium | NovaCorp | Eminence | Apex | ShadowBank | Vortex | |
|---|---|---|---|---|---|---|---|
Valor de acquirer |
sterling |
imperium |
novacorp |
eminence |
apex |
shadowbank |
vortex |
| Verificação do banco | Não tem hoje: aprova ou recusa na hora | Não tem: o resultado sai na própria tentativa | Uma janela de verificação; a tela do banco aparece nela quando ele pede | A tela do banco aparece dentro do próprio elemento quando ele pede | Não tem: aprova ou recusa na hora | Não tem: aprova ou recusa na hora | Não tem: aprova ou recusa na hora |
| No computador | Tudo dentro do elemento | Tudo dentro do elemento | Abre uma janela de verificação; o resultado volta para o elemento | Tudo dentro do elemento; a verificação aparece ali quando pedida | Tudo dentro do elemento | Tudo dentro do elemento | Tudo dentro do elemento |
| No celular, em navegador comum | Tudo dentro do elemento | Tudo dentro do elemento | A janela abre como nova aba e fecha quando o resultado sai | Tudo dentro do elemento | Tudo dentro do elemento | Tudo dentro do elemento | Tudo dentro do elemento |
| Em navegador de app (Instagram, Facebook, Google, TikTok) | Tudo dentro do elemento | Tudo dentro do elemento | A própria aba vai para a página segura de pagamento e termina lá | Tudo dentro do elemento | Tudo dentro do elemento | Tudo dentro do elemento | Tudo dentro do elemento |
| Eventos na sua página | Em todos os caminhos | Em todos os caminhos | No computador e no celular; nenhum no navegador de app | Em todos os caminhos | Em todos os caminhos | Em todos os caminhos | Em todos os caminhos |
| Tempo do resultado | Poucos segundos | Aprovação em segundos; uma recusa pode levar até 25 segundos | Depende do tempo que o comprador leva na tela do banco | Poucos segundos; mais quando o banco pede verificação | Poucos segundos; mais quando entra em análise antifraude | Poucos segundos; mais quando entra em análise antifraude | Poucos segundos; mais quando entra em análise antifraude |
| Tentativas por checkout | 5 | 5 | 6 | 5 | 5 | 5 | 5 |
| Validade do checkout | 24 horas | 24 horas | 24 horas | 24 horas | 24 horas | 24 horas | 24 horas |
Fechamento por recusa (failed) |
Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa | Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa | Na 6ª recusa, ou a partir de 10 minutos depois da última recusa, sem nova tentativa e com o comprador fora da página | Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa. Uma recusa depois da análise antifraude ou de uma confirmação demorada, ou um valor que a Eminence não aceita, fecha na hora | Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa. Um valor que a Apex não aceita fecha na hora | Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa | Na 5ª recusa, ou 10 minutos depois de uma recusa sem nova tentativa |
| Mínimo por venda | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente | Varia com a moeda e com a cotação do dia, ou o mínimo próprio da adquirente |
| Máximo por venda | Varia com a moeda e com a cotação do dia | Varia com a moeda e com a cotação do dia | Varia com a moeda e com a cotação do dia. Hoje é o mais baixo das sete | Varia com a moeda e com a cotação do dia | Varia com a moeda e com a cotação do dia | Varia com a moeda e com a cotação do dia | Varia com a moeda e com a cotação do dia |
| Moedas | As 48 da lista | As 48 da lista | As 48 da lista | As 48 da lista | As 48 da lista | As 48 da lista | As 48 da lista |
| Recorrência | Não | Não | Não | Não | Sim, nos sete ciclos de weekly a yearly |
Não | Sim, nos sete ciclos de weekly a yearly. A assinatura só começa a valer quando a primeira cobrança aprova |
| Upsell em um clique | Não | Não | Não | Não | Sim, com habilitação por conta | Não | Não |
| Idioma do checkout | Pelo país do comprador | Pelo país do comprador | Pelo país do comprador; ?nl= mostra outro idioma para teste |
Pelo país do comprador; ?nl= mostra outro idioma para teste |
Pelo país do comprador; ?nl= mostra outro idioma para teste |
Pelo país do comprador; ?nl= mostra outro idioma para teste |
Pelo país do comprador; ?nl= mostra outro idioma para teste |
| Idioma da mensagem de recusa | Pelo header Accept-Language da criação: português, inglês ou espanhol |
Pelo header Accept-Language da criação: português, inglês ou espanhol |
Pelo país do comprador, como o resto do checkout | Pelo país do comprador, como o resto do checkout | Pelo país do comprador, como o resto do checkout | Pelo país do comprador, como o resto do checkout | Pelo país do comprador, como o resto do checkout |
Códigos em throne-elements:error |
declined, attempts_exhausted, network, token, expired, ended |
Em message, sem code: network, expired e ended. Uma recusa chega como o texto mostrado ao comprador, inclusive a última; attempts_exhausted só ao abrir um checkout já fechado |
declined, attempts_exhausted, closed, window_closed, canceled, popup_blocked, timeout, network, expired, ended |
declined, attempts_exhausted, token, network, timeout, limit, expired, ended |
declined, attempts_exhausted, token, network, timeout, limit, expired, ended |
declined, attempts_exhausted, token, network, timeout, expired, ended |
declined, attempts_exhausted, token, network, timeout, expired, ended |
| Pagamento em análise | Pode acontecer (análise antifraude); a venda fica pending até a decisão |
Pode aparecer enquanto a confirmação sai; a venda fica pending |
Pode aparecer enquanto a confirmação sai; a venda fica pending |
Pode acontecer (análise antifraude, ou confirmação demorada); a venda fica pending até a decisão |
Pode acontecer (análise antifraude); a venda fica pending até a decisão. Reprovado conta como uma recusa |
Pode acontecer (análise antifraude); a venda fica pending até a decisão. Reprovado conta como uma recusa |
Pode acontecer (análise antifraude); a venda fica pending até a decisão. Reprovado conta como uma recusa |
| Estorno | Pelo suporte. Total vira refunded; parcial mantém paid com valores menores |
Pelo suporte. Vira refunded |
Pelo suporte. Vira refunded |
Pelo suporte. Total vira refunded; parcial mantém paid com valores menores |
Pelo suporte. Total vira refunded; parcial mantém paid com valores menores |
Pelo suporte. Total vira refunded; parcial mantém paid com valores menores |
Pelo suporte. Total vira refunded; parcial mantém paid com valores menores |
| Contestação | Vira chargeback e o valor líquido sai da carteira |
Vira chargeback; se revertida a seu favor, volta a paid |
Vira chargeback; se revertida a seu favor, volta a paid |
Vira chargeback e o valor líquido sai da carteira; se revertida a seu favor, volta a paid |
Vira chargeback e o valor líquido sai da carteira; se revertida a seu favor, volta a paid |
Vira chargeback e o valor líquido sai da carteira; se revertida a seu favor, volta a paid |
Vira chargeback e o valor líquido sai da carteira; se revertida a seu favor, volta a paid |
| Quando chega o webhook | Logo depois da aprovação, na maior parte das vendas | Logo depois da aprovação, na maior parte das vendas | Logo depois da aprovação quando o comprador volta da tela do banco; se ele sair antes, pela conferência automática, alguns minutos depois | Logo depois da aprovação; quando o banco pede verificação, depois que o comprador a conclui | Logo depois da aprovação; numa venda em análise, quando a análise aprova | Logo depois da aprovação; numa venda em análise, quando a análise aprova | Logo depois da aprovação; numa venda em análise, quando a análise aprova |
| Guia | Sterling | Imperium | NovaCorp | Eminence | Apex | ShadowBank | Vortex |
O máximo por venda de cada adquirente, já na moeda do seu público, está em GET /elements/acquirers?currency=.... Acima dele, a resposta é 422 invalid_amount com max_amount_cents e alternatives. Veja Escolher a adquirente.
Recorrência e upsell em um clique são campos opcionais do mesmo endpoint de criação: veja Recorrência e Upsell em um clique.
Qual escolher#
- Público que chega por anúncio em app (Instagram, Facebook, TikTok): Sterling, Imperium, Eminence, Apex e ShadowBank mantêm o comprador dentro da sua página e os eventos chegam sempre. Na NovaCorp, envie a conversão pelo servidor.
- Tíquete alto: confira o máximo de cada adquirente na moeda do seu público antes de escolher. Com mais de uma habilitada, crie as vendas altas com o
acquirerde uma que aceite o valor. - Banco que pede verificação: a NovaCorp abre a tela do banco numa janela; a Eminence mostra a verificação dentro do próprio elemento. Sterling, Imperium, Apex e ShadowBank não passam por essa etapa: o resultado sai na própria tentativa.
Recusa, expiração, estorno e contestação não geram webhook em nenhuma das seis. Acompanhe pelo GET /transactions/{id}. Os status estão em Status e ciclo de vida.