Desenvolvedores
API de pagamento cripto
Três chamadas: criar uma fatura, consultar o status, consultar o saldo. O cliente paga na página de pagamento e você recebe um webhook e USDT.
Endpoints
| Método | O que faz |
|---|---|
POST /api/v1/payments | Cria uma fatura e retorna o link da página de pagamento |
GET /api/v1/payments/{uuid} | Status, endereço e ID da transação |
GET /api/v1/wallet | Saldo de USDT disponível e congelado |
URL base: https://api.crybit.net · JSON · 60 requisições por minuto · autenticação: cabeçalhos X-Public-Key e X-Private-Key.
Criar uma fatura
Os únicos campos obrigatórios são amount e currency. Envie o seu próprio order_id para associar o pagamento a um pedido e ttl_minutes para definir o prazo de validade.
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageWebhooks e o widget
Quando uma fatura é paga, a CryBit chama a URL de webhook do seu merchant para que você libere o pedido. Para manter o cliente no seu site, solicite o tipo de confirmação embedded e abra o formulário de pagamento com o script do widget.
Referência
FAQ
Como faço a autenticação?
Envie a chave pública em X-Public-Key e a chave privada em X-Private-Key. Os dois cabeçalhos são obrigatórios. O merchant é identificado pela chave pública, então não é preciso informar o ID da loja na requisição.
Existe modo de teste?
Sim. Um merchant em modo de teste cria faturas de sandbox: a página de pagamento tem um botão para marcá-las como pagas, e elas não alteram o seu saldo. Mude o merchant para produção para aceitar transferências reais.
Quais são os limites?
A API aceita 60 requisições por minuto por chave. O valor da fatura começa em 0.01 e o prazo de validade vai de 5 a 1440 minutos.
