Skip to main content
Ao final deste guia, você terá uma transação com status paid no sandbox. O teste não movimenta dinheiro real.

Antes de começar

Você precisa de uma chave sk_test_. Se ainda não tem uma, veja como criar a chave. Exporte a chave no terminal:
Execute as chamadas no backend. Uma chave de API nunca deve chegar ao navegador.

1. Crie uma cobrança

Use 10002 para manter a cobrança pendente até você confirmar o pagamento no próximo passo.
A resposta contém os dados que sua aplicação usa:
Guarde data.id. Em uma integração real, apresente data.pixCode ao comprador.

2. Confirme o pagamento no sandbox

Substitua TRANSACTION_ID pelo id retornado:
O sandbox muda a transação para paid. Se você já configurou um webhook, ele também envia transaction.paid.

3. Consulte o resultado

Confirme que o campo status tem o valor paid.
Seu primeiro pagamento está concluído. Agora implemente a confirmação automática por webhook antes de usar produção.

Próximos passos

Consultar a operação

Veja os campos, a idempotência e as respostas de criação.

Consultar o status

Verifique o estado atual de uma transação.

Simular pagamento

Confirme, expire ou mantenha pendente no sandbox.

Configurar o webhook

Valide a assinatura e libere o pedido com transaction.paid.