Documentation Index
Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
Use this file to discover all available pages before exploring further.
En résumé
Blockradar Checkout vous permet d’accepter des paiements en stablecoins via des liens partageables, sans comptes clients ni intégrations complexes. Créez un lien, partagez-le et recevez les paiements directement sur votre wallet.
Blockradar Checkout vous permet d’accepter des paiements en stablecoins via des liens partageables, sans comptes clients ni intégrations complexes. Créez un lien, partagez-le et recevez les paiements directement sur votre wallet.
Prérequis
Avant de créer des liens de paiement, assurez-vous d’avoir :Clé API
Obtenez votre clé API depuis le Dashboard Blockradar. Accédez à Developers pour en générer une.
Master Wallet créée
Créez une master wallet via l’API Create Wallet ou depuis le dashboard. Les liens de paiement sont liés à une wallet.
Plan Checkout actif
Assurez-vous que la fonctionnalité Checkout est activée sur votre compte. Contactez [email protected] si vous devez l’activer.
Webhook configuré (facultatif)
Configurez les webhooks pour recevoir des notifications de paiement en temps réel. Consultez Webhooks pour les détails de configuration.
Introduction
Les liens de paiement sont des URLs partageables qui permettent à n’importe qui d’envoyer des paiements en stablecoins vers votre wallet. Ils sont parfaits pour :- E-commerce : Envoyer aux clients pour des achats de produits
- Facturation : Inclure dans les factures pour des services rendus
- Dons : Partager sur les réseaux sociaux ou les sites web
- Paiements de marketplace : Faciliter les transactions peer-to-peer
- Facturation par abonnement : Collecte de paiements récurrents
Comment fonctionnent les liens de paiement
Création
Créez un lien de paiement avec des paramètres spécifiques tels que le montant, le nom,
la description et les limites de paiement.
Partage
Partagez l’URL générée avec vos clients par e-mail, messagerie ou
intégrez-la sur votre site web.
Paiement
Les clients cliquent sur le lien, saisissent leurs informations de paiement et complètent la
transaction.
Confirmation
Vous recevez des notifications par webhook et pouvez suivre l’état du paiement en temps réel.
Fonctionnalités des liens de paiement
- Paramètres personnalisables : Définissez le montant, la description, les limites de paiement et la metadata
- URLs partageables : Générez des liens de paiement uniques pour chaque transaction
- Pré-remplissage des données client : Pré-remplissez les informations client via les paramètres de query de l’URL
- Suivi en temps réel : Surveillez l’état des paiements et recevez des notifications par webhook
- Support multi-réseau : Acceptez des paiements sur différents réseaux blockchain
- Intégration auto-sweep : Les fonds sont automatiquement consolidés vers la master wallet
Support multi-actifs
- USDT, USDC, DAI, BUSD sur plusieurs blockchains
- Ethereum, BSC, Polygon, Base, Arbitrum, Optimism, Tron, Solana, Celo
- Conversion et routage automatiques pour une expérience utilisateur optimale
Configuration flexible
- Montants fixes pour des produits/services spécifiques
- Montants variables pour les dons ou les paiements personnalisés
- Limites de paiement pour garantir la ponctualité des paiements
- Metadata personnalisée pour le suivi et l’analytique
- Notifications par webhook pour les mises à jour en temps réel
Sécurité et conformité
- Screening AML sur tous les paiements entrants
- Validation et vérification d’adresses
- Détection et prévention de la fraude
- Conformité réglementaire dans différentes juridictions
Flux de paiement
1. Création du lien de paiement
Lorsque vous créez un lien de paiement, Blockradar renvoie une URL de paiement unique :2. Pré-remplissage des données client avec les paramètres de query
Vous pouvez enrichir l’URL de paiement avec des paramètres de query pour pré-remplir automatiquement les informations client sur la page de paiement :name- Nom du client (apparaît sur la page de paiement)email- Adresse e-mail du clientreference- Référence personnalisée qui sera incluse dans les réponses de transactionamount- Pré-remplir le montant du paiement (remplace le montant par défaut du lien si défini)redirectUrl- URL vers laquelle rediriger après la finalisation du paiement
3. Redirection après paiement
Lorsqu’unredirectUrl est fourni, les clients seront automatiquement redirigés vers l’URL spécifiée une fois le traitement du paiement terminé. L’URL de redirection inclura les paramètres de query suivants :
Paramètres de query de la redirection :
status- État du paiement (success,failed,pending)tx_reference- ID de référence de la transactionreference- Votre référence personnalisée (si fournie)slug- Identifiant du lien de paiement
La redirection ne se produit qu’une fois le traitement du paiement terminé. Si aucun
redirectUrl n’est fourni, les clients verront la page de finalisation de paiement
par défaut.4. Configuration du montant
Les liens de paiement prennent en charge deux modes de montant : Montant fixe (prédéfini)- Lorsque vous spécifiez un
amountlors de la création, les clients ne peuvent pas modifier le montant du paiement - Idéal pour des produits ou services spécifiques avec un prix défini
- Exemple : Achat de produit pour exactement 99,99 $
- Lorsqu’aucun
amountn’est spécifié, les clients peuvent saisir leur propre montant de paiement - Parfait pour les dons, les pourboires ou les scénarios de tarification flexibles
- Les clients voient un champ de saisie de montant sur la page de paiement
4. Traitement du paiement
Les clients accèdent au lien de paiement, examinent les informations pré-remplies et complètent la transaction en utilisant leur stablecoin préférée.5. Réponse de la transaction
Le paramètrereference de l’URL sera inclus dans la réponse de la transaction et dans les payloads des webhooks, vous permettant de relier les paiements à vos systèmes internes.
Essayez
Découvrez les liens de paiement Blockradar grâce à notre démo en direct : 🔗 Lien de paiement de démonstration : https://pay.blockradar.co/demo Cette démo présente :- Flux de paiement : Expérience client complète, du lien à la finalisation
- UI/UX : Interface de paiement moderne et intuitive
- Options de stablecoins : Plusieurs méthodes de paiement et réseaux
- Mises à jour en temps réel : État de la transaction et confirmations en direct
Le lien de paiement de démonstration est destiné aux tests uniquement. Aucune transaction réelle
ne sera traitée.
Création de liens de paiement
Lien de paiement de base
Créez un lien de paiement simple pour un montant fixe :Lien de paiement à montant variable
Permettez aux clients de choisir le montant de leur paiement :Lien de paiement avec téléchargement de fichier
Incluez un fichier (par exemple, facture, image de produit) avec votre lien de paiement en utilisant form-data : Champs form-data :name: Service Invoicedescription: Web development services - January 2024amount: 1500.00redirectUrl: https://company.example.com/payment-successsuccessMessage: Payment received! We’ll start working on your project.metadata: invoice_id: INV-2024-001, service: web_developmentfile: [cover.png] (téléchargement de fichier)
Lorsque vous incluez des téléchargements de fichiers, utilisez form-data au lieu de JSON. Le fichier sera
stocké et accessible via le lien de paiement.
Paramètres du lien de paiement
Paramètres requis
| Paramètre | Type | Description |
|---|---|---|
name | string (max : 250) | Le nom du lien de paiement |
Paramètres facultatifs
| Paramètre | Type | Description |
|---|---|---|
description | string (max : 250) | Une description du lien de paiement |
slug | string (max : 250) | Un identifiant unique (compatible URL). Doit correspondre à la regex : ^[a-zA-Z0-9-]+$ |
amount | string | Le montant du lien de paiement. Doit être un nombre en string valide > 0 |
redirectUrl | string (URL) | L’URL vers laquelle rediriger l’utilisateur après le paiement. Doit inclure http:// ou https:// |
successMessage | string (max : 500) | Message affiché lorsque le paiement réussit |
inactiveMessage | string (max : 500) | Message affiché lorsque le lien de paiement est inactif |
metadata | object (JSON string) | Metadata personnalisée sous forme de paires clé-valeur (string ou nombre). Doit être envoyée comme JSON string en form-data |
paymentLimit | number (min : 1) | Nombre maximum de paiements autorisés pour ce lien |
file | file | Téléchargement de fichier facultatif (par exemple, image ou document) attaché au lien de paiement |
Flux de paiement
Expérience client
-
Cliquer sur le lien de paiement
- Le client reçoit et clique sur le lien de paiement
- Le lien ouvre une page de paiement sécurisée
-
Sélectionner la méthode de paiement
- Choisir parmi les stablecoins disponibles
- Sélectionner le réseau blockchain préféré
- Saisir le montant du paiement (si variable)
-
Compléter le paiement
- Le client confirme les détails de la transaction
- Le paiement est traité sur la blockchain
- Confirmation et mises à jour de l’état en temps réel
-
Confirmation de succès
- Page de confirmation de paiement
- Redirection facultative vers votre site web
- Reçu et détails de la transaction
Expérience marchand
-
Notifications en temps réel
- Événements webhook pour l’état du paiement
- Notifications par e-mail (si configurées)
- Mises à jour du dashboard
-
Suivi des paiements
- Historique et état des transactions
- Analytique et rapports de paiements
- Intégration à vos systèmes
Cycle de vie de l’adresse
Événements webhook
Les liens de paiement déclenchent les événements webhook suivants lorsque les paiements sont reçus :| Événement | Description |
|---|---|
deposit.success | Paiement reçu via le lien de paiement |
deposit.failed | Tentative de paiement échouée |
Exemple de payload webhook
Champs clés des données webhook
Le payload du webhook inclut des informations complètes sur le paiement :| Champ | Description |
|---|---|
reference | Référence personnalisée des paramètres de query de l’URL (par exemple, ORDER123, ID client) |
paymentLink | Détails complets du lien de paiement, y compris le nom, la description et la metadata |
asset | Informations sur l’actif (USDC, USDT, etc.) avec les détails du réseau |
blockchain | Informations sur le réseau (Base, Ethereum, etc.) |
wallet | Détails et configurations de la master wallet |
address | Adresse du client ayant reçu le paiement |
amlScreening | Résultats du screening anti-blanchiment d’argent |
assetSwept | État et détails de l’auto-sweep |
metadata | Données personnalisées du lien de paiement |
Le champ
reference dans les payloads webhook correspond au paramètre de query reference
que vous incluez dans l’URL de paiement. Cela vous permet de relier les paiements
à des commandes, des clients ou des références internes spécifiques de votre système.Bonnes pratiques
Sécurité
- Utilisez HTTPS pour le partage de tous les liens de paiement
- Surveillez les événements webhook pour détecter toute activité suspecte
- Mettez en œuvre le rate limiting sur vos endpoints webhook
Expérience utilisateur
- Descriptions claires de l’objet du paiement
- Pages de paiement optimisées pour mobile
- Plusieurs options de paiement lorsque possible
Intégration
- Stockez les IDs des liens de paiement pour le suivi
- Utilisez la metadata pour relier les paiements à vos systèmes
- Mettez en œuvre une logique de retry des webhooks pour la fiabilité
- Testez les webhooks d’abord en environnement sandbox
Cas d’usage et exemples
Boutique e-commerce
Facture de service
Campagne de dons
Service par abonnement
Ces exemples utilisent les paramètres corrects de l’API payment links de Blockradar. Le
champ
metadata doit être envoyé comme JSON string en form-data, et les téléchargements
de file sont pris en charge pour du contenu supplémentaire.Tests et développement
Environnement sandbox
- Utilisez les réseaux testnet pour le développement
- Testez la livraison et le traitement des webhooks
- Vérifiez les flux de paiement de bout en bout
- Testez les cas limites et les scénarios d’erreur
Tests de webhook
- Utilisez des outils tels que webhook.site pour les tests
- Vérifiez la validation des signatures
- Testez les mécanismes de retry
- Surveillez les taux de livraison des webhooks
Plan Checkout
Blockradar Checkout est une couche de paiement programmable en stablecoins pour accepter des paiements onchain via liens, QR codes intégrés et WalletConnect. Les fonds sont réglés directement sur vos wallets non-custodial avec un support intégré pour le swap, le bridge et le routage de trésorerie.Tarification
0,75 % par transaction
Tarification simple et transparente, sans frais d’abonnement mensuel.
Stablecoins prises en charge
- USDC, USDT, cNGN, IDRX, EUROC, et plus
Support multi-chain
- Ethereum, Polygon, Base, Solana, Tron, Celo, et plus
Gestion de trésorerie
- Swap et Bridge : Convertissez et déplacez des actifs entre les chaînes
- Auto-règlement : Réglez automatiquement dans votre devise préférée
- Circle Gateway : Accédez au protocole de transfert cross-chain de Circle
- Auto-sweeping : Consolidez les fonds vers votre master wallet
Ce plan n’inclut pas les fonctionnalités Wallet-as-a-Service (WaaS) ni le
provisionnement de wallets dédiées pour vos utilisateurs finaux.
Récupération des transactions d’un lien de paiement
Vous pouvez récupérer toutes les transactions associées à un lien de paiement spécifique en utilisant l’endpoint dédié aux transactions. Cela est utile pour :- Suivi des paiements : Surveiller tous les paiements reçus via un lien spécifique
- Rapprochement : Faire correspondre les paiements aux commandes ou aux factures
- Reporting : Générer des rapports pour des liens de paiement spécifiques
Paramètres de query
| Paramètre | Type | Description |
|---|---|---|
page | number | Numéro de page pour la pagination (par défaut : 1) |
limit | number | Nombre de résultats par page (par défaut : 10) |
status | string | Filtrer par état de transaction (par exemple, SUCCESS, PENDING, FAILED) |
type | string | Filtrer par type de transaction (par exemple, DEPOSIT) |
order | string | Ordre de tri (ASC ou DESC) |
Exemple de réponse
Support et ressources
Référence API
- Créer un lien de paiement
- Obtenir tous les liens de paiement
- Obtenir un lien de paiement
- Mettre à jour un lien de paiement
- Obtenir les transactions du lien de paiement
Obtenir de l’aide
- E-mail : [email protected]
- Référence API : Checkout
Checkout et les liens de paiement constituent un moyen puissant d’accepter des paiements en stablecoins avec un effort
d’intégration minimal. Commencez par des cas d’usage simples et ajoutez de la complexité
progressivement, à mesure que vous vous familiarisez avec le système.

