Documentation

blockwallets vous permet d’accepter l’USDT et l’USDC, ainsi que le BTC, le LTC et des cryptos natives (créditées en dollars américains à un taux verrouillé). Chaque intégration ci-dessous crée le même type de facture sur la même page de paiement hébergée, avec les mêmes confirmations, frais et solde ; seule change la manière dont votre système nous parle. Choisissez celle qui vous convient, puis suivez sa page.

Choisir une intégration

Regroupées selon votre point de départ. Chaque carte ouvre le guide complet.

Sans code

Encaissez depuis le tableau de bord marchand ; rien à installer.

Nouvelle intégration par API

Vous écrivez l’intégration à partir de zéro.

Migrer depuis une autre passerelle

Gardez votre code : des API compatibles, il vous suffit de changer l’URL de base et les clés.

Laisser l’IA intégrer

Pour ceux qui n’écrivent pas de code mais utilisent un outil de programmation IA.

Outils

Aide au débogage qui s’exécute dans votre navigateur.

Compatible Cryptomus ou native ?

Les deux créent les mêmes factures sur la même page de paiement, avec les mêmes frais et le même solde. La différence tient au style des requêtes, au format des webhooks et à la façon d’obtenir les identifiants.

Vous partez de zéro ? Utilisez l’API REST native : montants en cents, ref idempotent, signatures de webhook horodatées et clés que vous générez vous-même dans le tableau de bord. Vous êtes déjà sur Cryptomus, ou vous voulez utiliser un SDK ou un plugin Cryptomus existant ? Utilisez l’API compatible Cryptomus.

Démarrage rapide

De zéro à un paiement de test en cinq étapes (API compatible Cryptomus ; les autres API suivent les mêmes étapes avec leurs propres identifiants).

1. Demandez l’accès sur la page d’accueil. Une fois approuvé, connectez-vous au tableau de bord marchand.
2. Ouvrez « Développeurs › Intégration et clés » dans le tableau de bord, générez un merchant et une API key dans la colonne Test et ajoutez les domaines de votre site.
3. Votre serveur crée une facture avec POST /v1/payment et redirige le client vers result.url.
4. Payez-la avec « Simuler un paiement » sur la page de paiement, puis vérifiez que votre gestionnaire de webhook contrôle sign et crédite selon payment_amount_usd.
5. Passez aux identifiants de la colonne Live et payez une fois un petit montant réel (« Tester un paiement » sur la page d’accueil du tableau de bord).

POST https://blockwallets.io/v1/payment
merchant: <merchant>
sign: md5(base64(body) + API key)
Content-Type: application/json

{
  "amount": "42.00",
  "currency": "USD",
  "order_id": "order_1042",
  "url_callback": "https://shop.example/webhooks/crypto",
  "url_return": "https://shop.example/cart",
  "url_success": "https://shop.example/thanks?order=1042"
}

Le code Node.js, PHP et Python de chaque étape se trouve dans la documentation de l’API compatible Cryptomus ; si vous préférez qu’une IA s’en charge, commencez par le générateur de prompt.

Liens de paiement (sans code)

Tableau de bord marchand → « Encaissements › Liens de paiement » → saisissez une description et un montant (imposez un réseau ou laissez le client choisir) → créez. Chaque lien a une URL et un QR code.

• Chaque fois que quelqu’un ouvre le lien, une nouvelle facture est créée : un même lien peut donc être réutilisé (p. ex. « Abonnement 99 $ »).
• Chaque paiement apparaît dans « Encaissements › Transactions » ; retirez-le vers votre portefeuille depuis « Fonds › Solde et retraits ».
• Si vous avez créé des identifiants et une URL de webhook dans « Développeurs › Intégration et clés », les paiements par lien sont aussi notifiés, au format de webhook compatible Cryptomus.
• Pour arrêter d’encaisser, cliquez sur « Désactiver » : le lien cesse de fonctionner immédiatement.

Caisse POS pour boutiques

Pour les comptoirs et les stands : tableau de bord marchand → « Encaissements › Caisse POS » → ouvrez un terminal et récupérez un lien POS. Le personnel l’ouvre sur un téléphone ou une tablette, saisit un montant et un QR code de paiement s’affiche ; quand le client paie, l’écran indique « Paid ».

• Une facture POS est valable 30 minutes. Les paiements arrivent sur votre solde et apparaissent dans « Encaissements › Transactions », et vous êtes notifié sur votre URL de webhook comme pour les liens de paiement.
• Un lien POS ne sert qu’à encaisser : il ne voit ni votre solde, ni les retraits, ni les autres commandes, ni les réglages, ni les identifiants.
• Appareil perdu ou employé parti ? Révoquez ce terminal dans le tableau de bord et son lien cesse de fonctionner immédiatement.

Bouton à intégrer

Tableau de bord marchand → « Encaissements › Liens de paiement » → « Bouton à intégrer » : choisissez le texte, la couleur, la taille et la forme, puis copiez l’extrait. Un clic sur le bouton ouvre la page de paiement de ce lien de paiement.

• HTML simple : un lien stylé sans script, donc utilisable partout où l’on peut coller du HTML (créateurs de sites, forums, signatures d’e-mail).
• Avec le script : ajoutez data-blockwallets et une balise /embed.js ; sur ordinateur la page de paiement s’ouvre dans une petite fenêtre centrée, sur mobile elle s’ouvre normalement.
• Le script n’envoie aucune requête, ne dépose aucun cookie et n’ajoute aucun iframe. Si la page le bloque, le bouton reste un lien ordinaire qui fonctionne.

Dans les extraits ci-dessous, remplacez /l/pl_… par l’adresse de votre propre lien de paiement.

HTML simple

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>