- R$ 0,80por Pix recebido, fixo
- Até 12xno crédito, com 3DS
- 1 chamadade API pra criar a cobrança
- R$ 0de mensalidade e de adesão
O que é
O que é checkout transparente.
Checkout transparente é o pagamento de Pix, cartão ou boleto dentro do seu próprio site ou app, sem mandar o cliente para o domínio de outro gateway. O endereço e a marca continuam seus do carrinho ao obrigado; a AbacatePay processa por trás, com QR Code, campos de cartão e webhook. Guia: o que é checkout transparente.
Checkout redirecionado
- sualoja.com.br/carrinho
- pagamentos.gateway.com
- sualoja.com.br/obrigado
- O endereço muda no meio da compra
- Outra marca e outro visual na hora de pagar
- Mais uma página pra carregar no celular
Checkout transparente
- sualoja.com.br/carrinho
- sualoja.com.br/checkout
- O endereço não muda do carrinho ao obrigado
- Seu layout, sua marca e o seu texto
- Você decide o que mostrar se o pagamento falhar
Passo a passo
Como funciona o checkout transparente (passo a passo)
Do clique do cliente ao webhook no seu servidor — sem página nossa no meio. Cartão é ativado sob consulta.
- 1. O cliente escolhe Pix, cartão ou boleto no seu siteA tela de pagamento é sua: URL, layout e texto. Ele não troca de marca no último clique.
- 2. Seu backend cria a cobrança pela APIUma chamada a
POST /v2/transparents/createcom o método e o valor. No Pix, a resposta já traz QR Code e copia e cola. - 3. Você mostra o meio na sua páginaPix: QR e copia e cola. Cartão: campos do
abacatepay.jsem iframe; o backend recebe um token de uso único. Boleto: linha digitável (com Pix no mesmo boleto). - 4. Confirmação pelo webhookO evento
transparent.completedchega assinado quando o pagamento confirma. Aí você libera o pedido.
Comparativo
Checkout transparente × checkout redirecionado
Mesma cobrança, caminhos diferentes. O transparente mantém o cliente no seu domínio; o redirecionado manda ele para outra marca no meio da compra.
| Critério | Transparente | Redirecionado |
|---|---|---|
| Endereço | Continua no seu domínio | Muda para o domínio do gateway |
| Marca | Seu layout e sua marca | Outra marca na hora de pagar |
| Passos | Carrinho → checkout no site → obrigado | Carrinho → página do gateway → volta à loja |
| Conversão | Menos troca de tela e menos desconfiança no celular | Mais abas, mais chance de abandono no último clique |
Proteção no cartão: 3DS e antifraude. Meios: Pix, cartão e API Pix. Para subir a conversão depois: como aumentar a conversão no checkout.
Meios de pagamento
Pix, cartão e boleto no mesmo checkout.
Pix a R$ 0,80 (gateway Pix), boleto a R$ 2,50 só quando pago (gateway de boleto · API de boleto) e cartão a partir de 3,5% + R$ 0,60 (à vista, recebendo em D+30), até 12x, com 3DS (gateway de pagamento para cartão de crédito). Para loja virtual: gateway de pagamento para loja virtual. A API devolve o QR Code, a linha do boleto ou os campos seguros do cartão.
- Pix: QR Code em imagem e copia e cola, e o dinheiro cai na hora
- Boleto: linha digitável, código de barras e Pix no mesmo boleto
- Cartão: campos seguros do abacatepay.js, 3DS e até 12x
- Webhook avisando seu sistema assim que o pagamento é confirmado
Integração
Integração por API e webhook.
Seu backend fala com a API e o seu front mostra o resultado. Sem página nossa no meio. Comece pela API Pix ou pelo hub de desenvolvedores.
01 Crie a cobrançaSeu backend chama POST /v2/transparents/create com o método e o valor. No Pix, a resposta já traz o QR Code em imagem e o copia e cola.
02 Mostre na sua páginaExiba o QR Code, a linha do boleto ou os campos do cartão do abacatepay.js, com o visual do seu site.
03 Receba o webhookO evento transparent.completed chega assinado assim que o pagamento é confirmado. Aí é só liberar o pedido.
Requisição
curl https://api.abacatepay.com/v2/transparents/create \
-H "Authorization: Bearer $ABACATEPAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "method": "PIX", "data": { "amount": 28990 } }'Resposta
{
"data": {
"id": "pix_char_mXq2Lk7vB9nR4sT8",
"amount": 28990,
"status": "PENDING",
"brCode": "00020101021226950014br.gov.bcb.pix…",
"brCodeBase64": "data:image/png;base64,iVBORw0KG…",
"platformFee": 80,
"expiresAt": "2026-10-30T14:52:00.000Z"
},
"success": true,
"error": null
}{
"event": "transparent.completed",
"data": {
"transparent": {
"id": "pix_char_mXq2Lk7vB9nR4sT8",
"status": "PAID",
"amount": 28990
}
}
}Conversão
Checkout transparente aumenta a conversão?
Menos etapas, marca preservada e Pix na mesma tela quando o cartão falha — o cliente não precisa abrir outra aba pra terminar. Leia o caso em cartão recusado, Pix na mesma tela. Recursos extras: order bump, upsell e cupom no mesmo fluxo.
Feito pra quem integra
Integração sem susto, do teste à produção.
Ambiente de teste de verdade, webhook confiável e o cartão longe do seu servidor.
Modo de teste na mesma URL
A chave de teste define o ambiente. Simule o pagamento de um Pix com uma chamada e teste o cartão com o 4242.
Webhook assinado e insistente
Cada evento chega com assinatura HMAC-SHA256 e é tentado até 7 vezes, em cerca de 18 horas, se o seu servidor não responder.
O cartão não passa por você
Os campos rodam num iframe do abacatepay.js. Seu backend recebe só um token de uso único pra fazer a cobrança.
3DS e até 12x
Autenticação do banco do cliente quando ele exige, com parcelamento em até 12x. Visa e Mastercard.
Cobre de novo o mesmo cartão
Depois da primeira compra, o cardToken cobra o mesmo cartão sem o cliente digitar tudo de novo.
Pix só do titular
Com ensureSameTaxId, o Pix só é aceito se vier do CPF ou CNPJ do cliente da cobrança. Bom pra fatura e mensalidade.
Reembolso pela API
Estorno total de Pix e cartão com uma chamada, e o evento transparent.refunded no seu webhook.
Pronto pra integrar com IA
Cole o llms.txt da documentação na sua IA ou use o MCP da AbacatePay pra criar e consultar cobranças conversando.
Simule e veja quanto
você recebe de verdade.
R$ 0,80 por Pix, sem mensalidade,
e R$ 2,50 por boleto pago.
Compare os valores
na calculadora completa.
Você recebe no Pix na
R$599,20
Taxa fixa de R$ 0,80 por transação
- Taxa
- − R$ 0,80
- Taxa efetiva
- 0,13%
Qual usar?
Link de pagamento ou checkout transparente?
Mesma conta e mesmas taxas. Dá pra usar os dois ao mesmo tempo.
- Link de pagamentoPra quem vende na conversa ou ainda não tem site.
- Sem programar: cria no painel e cola no WhatsApp
- Pix, boleto e cartão em até 12x
- Um link só pra quantas vendas você quiser
- Cupons e checkout com a sua marca
- Checkout transparenteVocê está aquiPra quem tem site ou app e quer o pagamento dentro dele.
- Integração pela API, com webhook
- Pix, boleto e cartão em até 12x
- O cliente nunca sai do seu endereço
- A tela de pagamento é a sua, com o seu layout
Dúvidas sobre
o checkout?
As perguntas que mais recebemos de quem está integrando o checkout transparente.
O que é checkout transparente?
É quando o pagamento acontece dentro do seu site ou app, sem mandar o cliente pra uma página de outra empresa. Você mostra o QR Code do Pix, o boleto ou os campos do cartão no seu layout, e a AbacatePay processa por trás.
Qual a diferença entre checkout transparente e checkout com redirecionamento?
No redirecionado, o cliente sai da sua loja e cai numa página do gateway. No transparente, o endereço e o visual continuam seus: o cliente paga sem trocar de marca no meio da compra.
Dá pra fazer checkout transparente com Pix?
Dá. A API devolve o QR Code em imagem e o copia e cola pra você exibir na sua tela. A confirmação chega por webhook (transparent.completed).
Checkout transparente é seguro?
Sim. Os campos de cartão rodam num iframe do abacatepay.js: seu backend recebe só um token de uso único, e o número do cartão não passa pelo seu servidor. No crédito, a autenticação 3DS confirma o titular quando o banco pede. Cartão é ativado sob consulta.
Preciso de certificado PCI pra aceitar cartão no checkout transparente?
O cliente digita o cartão nos campos do abacatepay.js, que rodam num iframe seguro. Seu backend recebe só um token de uso único — o número do cartão não passa pelo seu servidor.
Quanto custa?
R$ 0,80 por Pix, R$ 2,50 por boleto pago e, no cartão, a partir de 3,5% + R$ 0,60 (à vista, recebendo em D+30). Sem mensalidade e sem taxa de adesão. Cartão é ativado sob consulta. A tabela completa está em abacatepay.com/pricing.
Funciona com Shopify, VTEX ou WooCommerce?
Sim. A AbacatePay integra com Shopify, Nuvemshop, WooCommerce, Loja Integrada, Magazord e VTEX (com o time). Para plataforma própria, a integração é via API. Veja abacatepay.com/integracoes.
Como sei que o pagamento foi confirmado?
Pelo webhook transparent.completed, assinado com HMAC-SHA256 e reenviado se o seu servidor não responder. No Pix, também dá pra consultar o status com GET /v2/transparents/check.
Dá pra testar antes de ir pro ar?
Dá. Com a chave de teste você usa a mesma URL da API, simula o pagamento de um Pix com POST /v2/transparents/simulate-payment e testa o cartão com o número 4242 4242 4242 4242.
Em quanto tempo o dinheiro cai?
O Pix cai no saldo na hora. O boleto, em até D+3 (dias úteis). O cartão, no prazo que você escolhe na dashboard: D+1, D+7, D+15 ou D+30.
Preciso de CNPJ?
Sim. Por enquanto a AbacatePay é só pra CNPJ. MEI serve.
Você leu até aqui.
Tá interessado né?
Cadastro em 2 minutos e a primeira cobrança de teste sai hoje.


