Como conecto meu site ou bot pela API?
Equipe ScarabPay · Atualizado em 19 outubro 2026
Use a API se quiser que os pedidos sejam pagos e entregues automaticamente. Seu servidor cria uma fatura, envia o cliente para a página de pagamento e recebe um webhook assinado quando o pagamento chega.
1. Pegue suas chaves
Abra o projeto e a aba Developers. Você recebe uma chave live para pagamentos reais e uma chave sandbox para testes.
Mantenha a chave em segredoA chave aparece só uma vez. Guarde-a apenas no seu servidor, nunca em um app ou página pública. Se vazar, toque em Replace key.
2. Adicione o webhook
- Informe a URL do seu site ou do servidor do bot que vai receber os eventos e toque em Save.
- Copie o segredo de assinatura e guarde no seu servidor.
- Toque em Send test event e confira se o servidor responde com status 200.
3. Crie faturas
Envie uma solicitação para criar uma fatura com o valor e o número do pedido e redirecione o cliente para o link de pagamento recebido. Quando chegar o evento invoice.paid, entregue o pedido.
Endereços fixos
Para recargas de saldo em bots, você pode dar a cada cliente um endereço de depósito permanente. Cada depósito envia o evento deposit.received.
Exemplos completos em PHP, Node.js e Python estão na documentação da API.