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éthodeCe que ça fait
POST /api/v1/paymentsCré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/walletSolde 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 page

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

À voir aussi