Développeurs
API de paiement crypto
Trois appels : créer une facture, consulter son statut, consulter le solde. Le client paie sur la page de paiement et vous recevez un webhook et de l'USDT.
Points de terminaison
| Méthode | Ce que ça fait |
|---|---|
POST /api/v1/payments | Créer une facture et obtenir le lien de la page de paiement |
GET /api/v1/payments/{uuid} | Statut, adresse et identifiant de transaction |
GET /api/v1/wallet | Solde USDT disponible et gelé |
URL de base : https://api.crybit.net · JSON · 60 requêtes par minute · authentification : en-têtes X-Public-Key et X-Private-Key.
Créer une facture
Les seuls champs obligatoires sont amount et currency. Passez votre propre order_id pour associer le paiement à une commande, et ttl_minutes pour définir la durée de vie.
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 et widget
Lorsqu'une facture est payée, CryBit appelle l'URL de webhook de votre marchand pour que vous puissiez libérer la commande. Pour garder le client sur votre site, demandez confirmation de type embedded et ouvrez le formulaire de paiement avec le script du widget.
Référence
FAQ
Comment s'authentifier ?
Envoyez la clé publique dans X-Public-Key et la clé privée dans X-Private-Key. Ces deux en-têtes sont obligatoires. Le marchand est identifié par la clé publique, aucun identifiant de boutique n'est donc nécessaire dans la requête.
Existe-t-il un mode test ?
Oui. Un marchand en mode test crée des factures sandbox : la page de paiement propose un bouton pour les marquer comme payées, et elles ne modifient pas votre solde. Passez le marchand en mode production pour accepter de vrais transferts.
Quelles sont les limites ?
L'API accepte 60 requêtes par minute et par clé. Le montant de la facture commence à 0,01, et la durée de vie va de 5 à 1440 minutes.
