Paiements crypto pour le SaaS
Laissez vos clients payer chaque période de facturation en USDT et autres cryptos. Vous créez un paiement par facture via l'API, envoyez le lien et prolongez l'accès quand le webhook indique que le paiement est terminé.
- Une facture par période de facturation
- Un paiement par facture via l'API
- Accès prolongé par webhook
Quand la crypto convient à une activité SaaS
La crypto est un second moyen de paiement, à côté des cartes, pour les clients que les rails de carte laissent de côté :
- des équipes dans des pays que votre processeur de cartes ne dessert pas, ou dont les cartes sont refusées pour des logiciels étrangers ;
- des entreprises qui préfèrent régler une grosse facture annuelle par virement plutôt que par carte ;
- des acheteurs d'outils pour développeurs, d'infrastructure et d'hébergement qui détiennent déjà des stablecoins en dollars.
L'expéditeur ne peut pas annuler un paiement crypto ; ces factures n'ont donc pas de rétrofacturations par carte. Cela ajoute un moyen de paiement ; cela ne remplace pas la facturation par carte pour tous les autres.
Le modèle : une facture par période de facturation
La facturation par carte débite automatiquement une carte enregistrée. Un paiement crypto doit être lancé par le client ; le modèle qui marche est donc une facture prépayée pour chaque période :
- Peu avant la fin de la période, votre système crée une facture et un paiement Qvard pour elle.
- Le client reçoit un lien vers la page de paiement hébergée, choisit un actif et un réseau et paie.
- Lorsque le paiement est terminé, Qvard appelle votre webhook et vous prolongez l'abonnement.
Il n'y a ni moyen de paiement enregistré ni prélèvement automatique. Qvard ne propose pas la facturation récurrente comme produit ; les rappels de renouvellement, le délai de grâce et les changements de forfait relèvent donc de votre propre logique.
Comment cela fonctionne
Créez le paiement depuis votre backend avec un seul POST vers https://api.qvard.com/api/v1/payment : votre clé dans l'en-tête x-api-key, votre numéro de facture comme id et le montant comme price, en dollars américains si vous n’envoyez pas currency, par exemple INR. La réponse contient un redirectUrl, l'adresse de la page de paiement hébergée ; placez-le dans l'e-mail de la facture.
Lorsque le paiement est terminé, Qvard envoie un webhook avec votre id et le statut completed. Vérifiez l'en-tête x-api-key, marquez la facture comme payée seulement si elle ne l'est pas déjà, répondez exactement HTTP 200 et prolongez l'abonnement. Le taux de la page de paiement est fixé pendant une heure.
// A few days before a period ends: create the invoice and its payment.
async function createRenewalInvoice(sub) {
const invoice = await db.invoices.create({ subscriptionId: sub.id, amountInr: sub.planPriceInr, status: 'open' });
const res = await fetch('https://api.qvard.com/api/v1/payment', {
method: 'POST',
headers: { 'x-api-key': process.env.QVARD_API_KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ id: String(invoice.id), price: invoice.amountInr, currency: 'INR' })
});
const { redirectUrl } = await res.json();
await mailer.send(sub.email, 'Your renewal invoice', 'Pay here: ' + redirectUrl);
}
// In the webhook handler, when status is "completed" (and the x-api-key header matches).
async function onPaid(invoiceId) {
const invoice = await db.invoices.markPaidIfOpen(invoiceId); // null if already paid
if (invoice) await db.subscriptions.extend(invoice.subscriptionId, '1 month');
}Ce qui reste de votre côté
Soyez clair sur ce que vous construisez et ce que la passerelle fait pour vous.
- Vous : les factures, les rappels, le délai de grâce, les montées et baisses de forfait, les remboursements et la comptabilité.
- La passerelle : la page de paiement, les adresses, la surveillance du réseau, les statuts de paiement et le webhook.
Si un client ne paie qu'une partie d'une facture, le paiement reçoit le statut partial et aucun webhook de fin n'est envoyé ; gardez la facture ouverte et demandez le reste. Les URL de retour après paiement ne sont pas encore disponibles ; donnez donc aux clients une page de facturation qui affiche l'état réel de la facture.
Argent et frais
Il n'y a pas d'abonnement pour la passerelle. La commission est individuelle pour votre projet et, selon la page des tarifs, part de 1 % et peut descendre jusqu'à 0,1 %. Les fonds restent sur votre solde Qvard et vous les retirez vers votre propre portefeuille ; le retrait ne coûte que les frais de réseau. Le retrait vers un compte bancaire en monnaie fiat n'est pas disponible. Les prix restent en dollars ; les clients paient l'équivalent dans l'actif et le réseau qu'ils choisissent.
Ce qui est prêt aujourd'hui
L'intégration passe par l'API, ce qui demande un développeur ; il n'existe pas encore de plugin de facturation prêt à l'emploi, et les liens de paiement et un sandbox séparé sont en développement. Lisez le guide complet dans paiements crypto pour le SaaS, le côté facturation dans facturation crypto pour le SaaS B2B et les règles du webhook dans comment sécuriser les webhooks de paiement crypto. Les formats de requête sont dans la documentation développeur, et une facture de démonstration montre ce que voit votre client.
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.