API de paiement crypto pensée pour les développeurs
Créez des factures crypto via l’API, redirigez les clients vers le checkout hébergé avec redirectUrl et recevez les statuts finaux par webhook.
x-api-key: sk_live_…
{
"id": "order_1024",
"price": 12499.00,
"currency": "INR"
}
// 201 Created
{
"data": {
"id": "8f3k2a1c",
"redirectUrl": "https://my.qvard.com/pay/8f3k2a1c"
},
"code": 201,
"message": "success",
"status": true
}API Qvard pour les développeurs
- Créez la facture et recevez redirectUrl
- Traitez le statut webhook final
- successUrl, failUrl et returnUrlBientôt disponible
x-api-key: sk_live_…
{
"id": "order_1024",
"status": "paid"
}1 requête, 1 redirection, 1 webhook
Créez un paiement, redirigez le client et traitez le webhook final : toute l’intégration tient sur une page.
Créez le paiement avec externalId, montant, devise et URLs.
Redirigez le client vers data.redirectUrl.
Recevez le webhook de statut final : wait, processing, completed ou rejected.
Encaissez dans votre devise, comptabilité en USD
Indiquez le montant dans n’importe quelle devise ISO-4217 avec le champ currency, par exemple INR, RUB ou EUR. Sans ce champ, le montant est en USD, comme auparavant.
- Le taux de Qvard est fixé une seule fois, à la création du paiement. Le payeur voit le montant dans votre devise et le montant dans le token qu’il utilise ; le paiement est enregistré en USD.
- Les limites sont vérifiées en USD après conversion. Si le montant sort de la fourchette, le message d’erreur affiche la limite dans votre devise.
- Les taux actuels sont sur la page des taux et dans l’API : GET /api/v1/rates, sans clé. Dans les paramètres de votre boutique, vous pouvez définir votre propre taux pour chaque devise.
- Erreurs : 422 unsupported_currency — devise non prise en charge ; 422 rate_unavailable — pas de taux ; 422 invalid_amount_precision — plus de décimales que la devise n’en autorise (JPY 0, KWD 3, la plupart 2).
curl "https://api.qvard.com/api/v1/rates?currencies=EUR,INR"
// 200 OK
{ "data": { "base": "USD", "updatedAt": "…", "rates": { "EUR": 0.92, "INR": … } } }Vérifiez les signatures de webhook
Chaque webhook Qvard est signé avec HMAC-SHA256. Apprenez à vérifier la signature et à vous protéger contre les contrefaçons avec du code prêt à l'emploi pour Node.js et PHP.
FAQ
A quick overview of how Qvard handles payments, integration and merchant operations.
Qu’est-ce que Qvard ?
Qvard est une passerelle de paiement crypto pour les entreprises avec checkout hébergé, factures, paiements API et soldes marchands.
Quels actifs sont pris en charge ?
Qvard prend en charge USDT, USDC, BTC, LTC, TRX, BNB et ETH. TON et USDT sur TON arrivent bientôt.
Est-ce adapté aux développeurs ?
Oui. Qvard inclut les paiements API, redirectUrl, les webhooks, les relances et les journaux de livraison.
Puis-je personnaliser le checkout ?
Le checkout prend en charge le logo du marchand, le nom de la boutique, la couleur du bouton et la localisation. Les URL de retour personnalisées arrivent bientôt.
Que faut-il pour commencer ?
Créez un compte marchand et terminez la vérification de l’entreprise. Après avoir testé une facture démo, connectez le checkout hébergé ou l’API et commencez à accepter de vrais paiements.
Comment fonctionnent les retraits ?
Les fonds sont suivis dans les soldes marchands, séparés par actif et par réseau. Vous pouvez retirer manuellement ou définir des règles de retrait pour des versements automatiques.