Desarrolladores
API de pagos cripto
Tres llamadas: crear una factura, consultar su estado y consultar el saldo. El cliente paga en la página de pago y usted recibe un webhook y USDT.
Endpoints
| Método | Qué hace |
|---|---|
POST /api/v1/payments | Crea una factura y devuelve el enlace a la página de pago |
GET /api/v1/payments/{uuid} | Estado, dirección e id de la transacción |
GET /api/v1/wallet | Saldo de USDT disponible y congelado |
URL base: https://api.crybit.net · JSON · 60 solicitudes por minuto · autenticación: encabezados X-Public-Key y X-Private-Key.
Cree una factura
Los únicos campos obligatorios son amount y currency. Pase su propio order_id para asociar el pago con un pedido, y ttl_minutes para definir la vigencia.
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 y el widget
Cuando se paga una factura, CryBit llama a la URL de webhook de su comercio para que usted pueda liberar el pedido. Para mantener al cliente en su sitio, solicite el tipo de confirmación embedded y abra el formulario de pago con el script del widget.
Referencia
FAQ
¿Cómo me autentico?
Envíe la clave pública en X-Public-Key y la clave privada en X-Private-Key. Ambos encabezados son obligatorios. El comercio se identifica por la clave pública, por lo que no hace falta un id de tienda en la solicitud.
¿Hay un modo de prueba?
Sí. Un comercio en modo de prueba crea facturas de sandbox: la página de pago tiene un botón para marcarlas como pagadas y no modifican su saldo. Cambie el comercio a modo real para aceptar transferencias reales.
¿Cuáles son los límites?
La API acepta 60 solicitudes por minuto por clave. El monto de la factura parte de 0.01 y la vigencia es de 5 a 1440 minutos.
