Desarrolladores
Cree una factura
Una solicitud POST crea una factura y devuelve el enlace a la página de pago. Allí el cliente elige una moneda y una red.
Solicitud
curl
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"}'| Campo | Significado |
|---|---|
amount | Obligatorio. Un número desde 0.01. Existe un mínimo en USDT porque la comisión de red no puede superar la factura cuando la paga el comercio: consulte GET /api/payments/quote para ver el mínimo actual. |
currency | Obligatorio. Fiat (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT y otras monedas principales) o USDT/USDC. El monto se convierte al tipo de cambio en vivo. |
order_id | Su propio id de pedido, hasta 80 caracteres. Si está vacío, CryBit genera CB-…. |
purpose | Descripción, hasta 240 caracteres. |
ttl_minutes | Vigencia de 5 a 1440 minutos, 30 por defecto. |
return_url | Adónde vuelve el cliente tras el pago (http o https, hasta 500 caracteres). Si no se indica, se usa la URL de retorno del comercio. |
crypto, network | Opcional. Pase ambos para obtener de inmediato la dirección, el monto y un código QR en la respuesta, por ejemplo USDT y TRC-20. |
confirmation | Opcional. {"type":"embedded"} para el widget integrado. El token siempre viene en la respuesta. |
Respuesta
La respuesta es 201 con el objeto de la factura. Envíe al cliente a callback_url (la página de pago). Sin crypto y network, needs_method es true y el cliente elige en esa página.
JSON
{
"uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
"order_id": "ORD-1048",
"amount": 1490,
"currency": "RUB",
"status": "waiting",
"sandbox": true,
"needs_method": true,
"callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
"confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
"expires_at": "2026-09-21T13:41:42+00:00"
}Estado
GET /api/v1/payments/{uuid} devuelve el mismo objeto. El estado es waiting, paid, expired o cancelled. Cuando el cliente elige una red, el objeto incluye crypto, network, address y la comisión; tras el pago incluye status paid, txid y paid_at. Una factura waiting cuya vigencia ha pasado se convierte en expired cuando se consulta. fee_payer es shop cuando el comercio paga la comisión y buyer cuando el monto a pagar ya la incluye.
FAQ
¿Qué encabezados envío?
X-Public-Key y X-Private-Key, ambos obligatorios. Una clave privada ausente, incorrecta o antigua devuelve 401.
¿Hay un límite de solicitudes?
60 solicitudes por minuto por clave.