Integrando o Checkout
Atualizado em · 2 min de leitura
RecenteConfigure um fluxo completo de pagamento com cartão, Pix e boleto.
Este guia mostra como implementar um checkout completo aceitando cartão de crédito, Pix e boleto bancário.
Escolha os métodos de pagamento
Defina quais métodos serão oferecidos ao cliente. Cartão é processado imediatamente; Pix e boleto geram um código de pagamento para o cliente pagar.
Colete os dados do pagador
Sempre colete nome, CPF/CNPJ e e-mail do cliente. Para cartão, colete os dados do cartão ou use tokenização para não trafegar dados sensíveis.
Crie a transação
Chame `POST /transactions` com os dados coletados. Para cada método, o retorno tem campos específicos (QR code para Pix, linha digitável para boleto).
Exiba a confirmação
Redirecione para a tela de confirmação. Para Pix e boleto, exiba as instruções de pagamento. Para cartão, mostre o status imediatamente.
Configure webhooks
Monitore `transaction.paid` para confirmar o pedido no seu sistema após o pagamento.
Cartão de Crédito
const res = await fetch('{apiUrl}/transactions', {
method: 'POST',
headers: {
'Authorization': 'Bearer {token}',
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 15000,
payment_method: 'credit_card',
installments: 3,
card: {
number: '4111111111111111',
holder_name: 'Maria Silva',
exp_month: 12,
exp_year: 2028,
cvv: '123',
},
customer: {
name: 'Maria Silva',
email: 'maria@exemplo.com',
document: '11144477735',
},
}),
});Pix
const res = await fetch('{apiUrl}/transactions', {
method: 'POST',
headers: {
'Authorization': 'Bearer {token}',
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 15000,
payment_method: 'pix',
customer: {
name: 'Maria Silva',
email: 'maria@exemplo.com',
document: '11144477735',
},
}),
});
const { order } = await res.json();
// order.pix.qr_code — string para o QR code
// order.pix.qr_code_url — URL da imagem do QR code
// order.pix.expiration_date — validade do PixBoleto
const res = await fetch('{apiUrl}/transactions', {
method: 'POST',
headers: {
'Authorization': 'Bearer {token}',
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 15000,
payment_method: 'boleto',
customer: {
name: 'Maria Silva',
email: 'maria@exemplo.com',
document: '11144477735',
},
boleto: {
due_at: '2026-04-01',
},
}),
});
const { order } = await res.json();
// order.boleto.url — URL do boleto PDF
// order.boleto.barcode — código de barras[!TIP] Use o ambiente Sandbox para testar todos os métodos sem movimentar dinheiro. Veja o guia Testar em Sandbox para os dados de teste.
Próximos passos
- Criar transação — todos os parâmetros disponíveis
- Tokenização — salve cartões sem armazenar dados sensíveis
- Configurar Webhooks — confirme pedidos automaticamente