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étodoO que faz
POST /api/v1/paymentsCria 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/walletSaldo 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 page

Webhooks 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.

Relacionados