Métodos disponíveis
Cartão de crédito ainda não está disponível. As páginas de cartão descrevem como vai funcionar quando lançar. Por enquanto, use PIX.
Um método só pode ser usado quando estiver habilitado no projeto. Não habilite um método apenas porque ele aparece em um payload ou enum antigo da API.
Escolha como integrar
Fluxo comum
1
Configure o ambiente
Crie uma chave
sk_test_ e habilite os métodos que deseja aceitar. Comece pelo Sandbox.2
Crie o pagamento
Use uma transação direta para PIX ou crie uma sessão de checkout com
paymentMethods, como ['pix'] ou ['crypto'].3
Mostre o próximo passo ao comprador
No PIX, exiba o
pixCode e o QR Code. Em cripto, redirecione o comprador para a checkoutUrl da página hospedada. No cartão, use o checkout hospedado ou o SDK para tokenização e autenticação 3DS.4
Confirme no servidor
Receba o evento
transaction.paid, verifique a assinatura e libere o pedido apenas depois da confirmação. A página de retorno do checkout não substitui o webhook.Estados e confirmação
Use o status da transação ou da sessão para exibir o estado ao comprador, mas trate o webhook como a fonte de verdade no backend. Um201 confirma que o recurso foi criado; não confirma que o pagamento foi aprovado.
Os estados específicos podem variar por método. Consulte a referência de PIX, a referência de cartão e os webhooks antes de implementar a máquina de estados do seu pedido.
Próximos passos
Começar no Sandbox
Teste criação, pagamento, expiração e webhooks sem movimentar dinheiro real.
Ir para produção
Passe pelo checklist de segurança, idempotência e confirmação antes de usar
sk_live_.