Liens de Paiement - Blockradar

Les liens de paiement offrent un moyen simple d’accepter des paiements en stablecoins sans exiger que les clients aient un compte Blockradar ou s’integrent directement a votre application.

Introduction

Les liens de paiement sont des URL partageables qui permettent a quiconque d’envoyer des paiements en stablecoins a votre portefeuille. Ils sont parfaits pour :

E-commerce : Envoyer aux clients pour les achats de produits
Facturation : Inclure dans les factures pour les services rendus
Dons : Partager sur les reseaux sociaux ou les sites web
Paiements de marketplace : Faciliter les transactions pair-a-pair
Facturation d’abonnement : Collecte de paiements recurrents

Comment Fonctionnent les Liens de Paiement

Creation

Creez un lien de paiement avec des parametres specifiques comme le montant, le nom, la description et les limites de paiement.

Partage

Partagez l’URL generee avec vos clients par email, messagerie ou integrez-la sur votre site web.

Paiement

Les clients cliquent sur le lien, entrent leurs details de paiement et completent la transaction.

Confirmation

Vous recevez des notifications webhook et pouvez suivre le statut du paiement en temps reel.

Fonctionnalites des Liens de Paiement

Parametres Personnalisables : Definissez le montant, la description, les limites de paiement et les metadonnees
URL Partageables : Generez des liens de paiement uniques pour chaque transaction
Pre-remplissage Client : Pre-remplissez les details du client via les parametres de requete URL
Suivi en Temps Reel : Surveillez le statut du paiement et recevez des notifications webhook
Support Multi-reseau : Acceptez des paiements sur differents reseaux blockchain
Integration Auto-sweep : Les fonds sont automatiquement consolides vers le portefeuille principal

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 experience utilisateur optimale

Configuration Flexible

Montants fixes pour des produits/services specifiques
Montants variables pour les dons ou paiements personnalises
Limites de paiement pour assurer des paiements ponctuels
Metadonnees personnalisees pour le suivi et l’analytique
Notifications webhook pour les mises a jour en temps reel

Securite et Conformite

Verification AML sur tous les paiements entrants
Validation d’adresse et verification
Detection de fraude et prevention
Conformite reglementaire dans toutes les juridictions

Flux de Paiement

1. Creation du Lien de Paiement

Lorsque vous creez un lien de paiement, Blockradar retourne une URL de paiement unique :

{
  "id": "pl_123456789",
  "name": "Product Purchase",
  "url": "https://pay.blockradar.co/payment-link-10012",
  "amount": "100.00",
  "currency": "USD",
  "active": true
}

2. Pre-remplissage Client avec Parametres de Requete

Vous pouvez ameliorer l’URL de paiement avec des parametres de requete pour pre-remplir automatiquement les details du client sur la page de paiement :

https://pay.blockradar.co/payment-link-10012?name=Customer&[email protected]&reference=ORDER123&amount=99.99&redirectUrl=https://yoursite.com/payment-success

Parametres de Requete Optionnels Pris en Charge :

name - Nom du client (apparait sur la page de paiement)
email - Adresse email du client
reference - Reference personnalisee qui sera incluse dans les reponses de transaction
amount - Pre-remplir le montant du paiement (remplace le montant par defaut du lien si defini)
redirectUrl - URL vers laquelle rediriger apres la completion du paiement

3. Redirection Post-Paiement

Lorsqu’une redirectUrl est fournie, les clients seront automatiquement rediriges vers votre URL specifiee apres que le traitement du paiement soit complete. L’URL de redirection inclura les parametres de requete suivants : Parametres de Requete de Redirection :

status - Statut du paiement (success, failed, pending)
tx_reference - ID de reference de transaction
reference - Votre reference personnalisee (si fournie)
slug - Identifiant du lien de paiement

Exemple d’URL de Redirection :

https://yoursite.com/payment-success?status=success&tx_reference=tx_abc123&reference=ORDER123&slug=payment-link-10012

La redirection ne se produit qu’apres que le traitement du paiement soit complete. Si aucune redirectUrl n’est fournie, les clients verront la page de completion de paiement par defaut.

4. Configuration du Montant

Les liens de paiement supportent deux modes de montant : Montant Fixe (Pre-defini)

Lorsque vous specifiez un amount lors de la creation, les clients ne peuvent pas modifier le montant du paiement
Ideal pour des produits ou services specifiques avec des prix fixes
Exemple : Achat de produit pour exactement 99,99$

Montant Variable (Saisie Client)

Lorsqu’aucun amount n’est specifie, les clients peuvent entrer leur propre montant de paiement
Parfait pour les dons, pourboires ou scenarios de prix flexibles
Les clients voient un champ de saisie de montant sur la page de paiement

4. Traitement du Paiement

Les clients visitent le lien de paiement, examinent les details pre-remplis et completent la transaction en utilisant leur stablecoin prefere.

5. Reponse de Transaction

Le parametre reference de l’URL sera inclus dans la reponse de transaction et les payloads webhook, vous permettant de lier les paiements a vos systemes internes.

Essayez-le

Decouvrez les liens de paiement Blockradar de premiere main avec notre demo en direct : Lien de Paiement Demo : https://pay.blockradar.co/demo Cette demo presente :

Flux de Paiement : Experience client complete du lien a la completion
UI/UX : Interface de paiement moderne et intuitive
Options Stablecoin : Multiples methodes de paiement et reseaux
Mises a Jour en Temps Reel : Statut de transaction et confirmations en direct

Le lien de paiement demo est a des fins de test uniquement. Aucune transaction reelle ne sera traitee.

Creation des Liens de Paiement

Lien de Paiement Basique

Creez un lien de paiement simple pour un montant fixe :

{
  "name": "Product Purchase",
  "description": "Payment for Laptop Pro 2024",
  "amount": "100.00",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase!",
  "metadata": "{\"product_id\": \"prod_123\", \"order_id\": \"ord_456\"}"
}

Lien de Paiement a Montant Variable

Permettez aux clients de choisir leur montant de paiement :

{
  "name": "Donation Campaign",
  "description": "Support our disaster relief efforts",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation!",
  "metadata": "{\"campaign\": \"disaster_relief_2024\"}"
}

Lien de Paiement avec Upload de Fichier

Incluez un fichier (ex. facture, image de produit) avec votre lien de paiement en utilisant form-data : Champs Form Data :

name : Service Invoice
description : Web development services - January 2024
amount : 1500.00
redirectUrl : https://company.example.com/payment-success
successMessage : Payment received! We’ll start working on your project.
metadata : invoice_id: INV-2024-001, service: web_development
file : [cover.png] (upload de fichier)

Lors de l’inclusion d’uploads de fichiers, utilisez form-data au lieu de JSON. Le fichier sera stocke et accessible via le lien de paiement.

Parametres des Liens de Paiement

Parametres Requis

Parametre	Type	Description
`name`	string (max: 250)	Le nom du lien de paiement

Parametres Optionnels

Parametre	Type	Description
`description`	string (max: 250)	Une description du lien de paiement
`slug`	string (max: 250)	Un identifiant unique (compatible URL). Doit correspondre a la regex : `^[a-zA-Z0-9-]+$`
`amount`	string	Le montant pour le lien de paiement. Doit etre un nombre valide > 0
`redirectUrl`	string (URL)	L’URL vers laquelle rediriger l’utilisateur apres le paiement. Doit inclure http:// ou https://
`successMessage`	string (max: 500)	Message affiche lorsque le paiement reussit
`inactiveMessage`	string (max: 500)	Message affiche lorsque le lien de paiement est inactif
`metadata`	object (JSON string)	Metadonnees personnalisees sous forme de paires cle-valeur (string ou number). Doit etre envoye comme chaine JSON en form-data
`paymentLimit`	number (min: 1)	Nombre maximum de paiements autorises pour ce lien
`file`	file	Un upload de fichier optionnel (ex. image ou document) attache au lien de paiement

Flux de Paiement

Experience Client

Cliquer sur le Lien de Paiement
- Le client recoit et clique sur le lien de paiement
- Le lien ouvre une page de paiement securisee
Selectionner la Methode de Paiement
- Choisir parmi les stablecoins disponibles
- Selectionner le reseau blockchain prefere
- Entrer le montant du paiement (si variable)
Completer le Paiement
- Le client confirme les details de la transaction
- Le paiement est traite sur la blockchain
- Confirmation et mises a jour de statut en temps reel
Confirmation de Succes
- Page de confirmation du paiement
- Redirection optionnelle vers votre site web
- Recu et details de la transaction

Experience Marchand

Notifications en Temps Reel
- Evenements webhook pour le statut du paiement
- Notifications email (si configurees)
- Mises a jour du tableau de bord
Suivi des Paiements
- Historique et statut des transactions
- Analytique et reporting des paiements
- Integration avec vos systemes

Evenements Webhook

Les liens de paiement declenchent les evenements webhook suivants lorsque les paiements sont recus :

Evenement	Description
`deposit.success`	Le paiement a ete recu via le lien de paiement
`deposit.failed`	La tentative de paiement a echoue

Exemple de Payload Webhook

{
  "event": "deposit.success",
  "data": {
    "id": "0d7a0b98-943c-48d0-8baa-216c29956050",
    "reference": "bjXPk7d00",
    "senderAddress": "0x451dEFC27B45808078e875556AF06bCFdC697BA4",
    "recipientAddress": "0x9D8dF15628B737CAf63a92Abd8E8bb304210eA94",
    "tokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "1",
    "amountPaid": "1",
    "amountUSD": "1",
    "rateUSD": "1",
    "fee": null,
    "feeHash": null,
    "currency": "USD",
    "toCurrency": null,
    "blockNumber": 34771099,
    "blockHash": "0xa9dc060dbe649676a15ae1faee725851fe1ecf2401b200e60fff33fc0ff41e84",
    "hash": "0x9f01af8f517afb3fd3ee17f36dabee03a4d6514885473115815de86c28ea7dfb",
    "confirmations": 6,
    "confirmed": true,
    "gasPrice": "7026436",
    "gasUsed": "62159",
    "gasFee": "0.000000436756235324",
    "status": "SUCCESS",
    "type": "DEPOSIT",
    "amlScreening": {
      "provider": "ofac, fbi, tether, circle",
      "status": "success",
      "message": "Address is not sanctioned"
    },
    "assetSwept": true,
    "network": "mainnet",
    "chainId": 8453,
    "metadata": {},
    "paymentLink": {
      "id": "dd8eb830-0971-4f61-97bc-b1ad352e1c48",
      "name": "Blockradar Checkout Demo",
      "slug": "demo"
    }
  }
}

Champs Cles des Donnees Webhook

Le payload webhook inclut des informations completes sur le paiement :

Champ	Description
`reference`	Reference personnalisee des parametres de requete URL (ex. ORDER123, customer ID)
`paymentLink`	Details complets du lien de paiement incluant nom, description et metadonnees
`asset`	Informations sur l’actif (USDC, USDT, etc.) avec details du reseau
`blockchain`	Informations sur le reseau (Base, Ethereum, etc.)
`wallet`	Details et configurations du portefeuille principal
`address`	Adresse client qui a recu le paiement
`amlScreening`	Resultats de la verification anti-blanchiment
`assetSwept`	Statut et details du balayage automatique
`metadata`	Donnees personnalisees du lien de paiement

Le champ reference dans les payloads webhook correspond au parametre de requete reference que vous incluez dans l’URL de paiement. Cela vous permet de tracer les paiements vers des commandes, clients ou references internes specifiques dans votre systeme.

Bonnes Pratiques

Securite

Utilisez HTTPS pour tout partage de liens de paiement
Surveillez les evenements webhook pour toute activite suspecte
Implementez une limitation de debit sur vos endpoints webhook

Experience Utilisateur

Descriptions claires de ce pour quoi est le paiement
Pages de paiement optimisees mobile
Multiples options de paiement quand possible

Integration

Stockez les IDs des liens de paiement pour le suivi
Utilisez les metadonnees pour lier les paiements a vos systemes
Implementez une logique de retry webhook pour la fiabilite
Testez les webhooks d’abord dans l’environnement sandbox

Cas d’Utilisation et Exemples

Boutique E-commerce

{
  "name": "Laptop Pro 2024",
  "description": "High-performance laptop with latest specifications",
  "amount": "299.99",
  "redirectUrl": "https://store.example.com/thank-you",
  "successMessage": "Thank you for your purchase! Your order has been confirmed.",
  "metadata": "{\"product_id\": \"laptop_pro_2024\", \"category\": \"electronics\", \"customer_email\": \"[email protected]\"}",
  "paymentLimit": 1
}

Facture de Service

{
  "name": "Web Development Services",
  "description": "Professional web development services - January 2024",
  "amount": "1500.00",
  "redirectUrl": "https://company.example.com/payment-success",
  "successMessage": "Payment received! We'll start working on your project immediately.",
  "metadata": "{\"invoice_id\": \"INV-2024-001\", \"service\": \"web_development\", \"client_id\": \"client_789\"}",
  "paymentLimit": 1
}

Campagne de Dons

{
  "name": "Disaster Relief 2024",
  "description": "Support our disaster relief efforts in affected regions",
  "amount": "10.00",
  "redirectUrl": "https://charity.example.com/thank-you",
  "successMessage": "Thank you for your generous donation! Every contribution makes a difference.",
  "metadata": "{\"campaign\": \"disaster_relief_2024\", \"organization\": \"charity_foundation\", \"tax_deductible\": true}",
  "paymentLimit": 1000
}

Service d’Abonnement

{
  "name": "Premium Plan Monthly",
  "description": "Monthly subscription to our premium service",
  "amount": "29.99",
  "redirectUrl": "https://service.example.com/welcome",
  "successMessage": "Welcome to Premium! Your subscription is now active.",
  "metadata": "{\"plan\": \"premium_monthly\", \"billing_cycle\": \"monthly\", \"features\": \"unlimited_access\"}",
  "paymentLimit": 100
}

Ces exemples utilisent les parametres corrects de l’API des liens de paiement Blockradar. Le champ metadata doit etre envoye comme chaine JSON en form-data, et les uploads de file sont pris en charge pour du contenu supplementaire.

Tests et Developpement

Environnement Sandbox

Utilisez les reseaux testnet pour le developpement
Testez la livraison et la gestion des webhooks
Verifiez les flux de paiement de bout en bout
Testez les cas limites et les scenarios d’erreur

Test des Webhooks

Utilisez des outils comme webhook.site pour les tests
Verifiez la validation des signatures
Testez les mecanismes de retry
Surveillez les taux de livraison des webhooks

Support et Ressources

Reference API

Obtenir de l’Aide

Email : [email protected]
Reference API : Liens de Paiement

Les liens de paiement sont un moyen puissant d’accepter des paiements en stablecoins avec un effort d’integration minimal. Commencez avec des cas d’utilisation simples et ajoutez progressivement de la complexite a mesure que vous vous familiarisez avec le systeme.

Démarrage

Essentiels

​Introduction

​Comment Fonctionnent les Liens de Paiement

Creation

Partage

Paiement

Confirmation

​Fonctionnalites des Liens de Paiement

​Support Multi-actifs

​Configuration Flexible

​Securite et Conformite

​Flux de Paiement

​1. Creation du Lien de Paiement

​2. Pre-remplissage Client avec Parametres de Requete

​3. Redirection Post-Paiement

​4. Configuration du Montant

​4. Traitement du Paiement

​5. Reponse de Transaction

​Essayez-le

​Creation des Liens de Paiement

​Lien de Paiement Basique

​Lien de Paiement a Montant Variable

​Lien de Paiement avec Upload de Fichier

​Parametres des Liens de Paiement

​Parametres Requis

​Parametres Optionnels

​Flux de Paiement

​Experience Client

​Experience Marchand

​Evenements Webhook

​Exemple de Payload Webhook

​Champs Cles des Donnees Webhook

​Bonnes Pratiques

​Securite

​Experience Utilisateur

​Integration

​Cas d’Utilisation et Exemples

​Boutique E-commerce

​Facture de Service

​Campagne de Dons

​Service d’Abonnement

​Tests et Developpement

​Environnement Sandbox

​Test des Webhooks

​Support et Ressources

​Reference API

​Obtenir de l’Aide

Introduction

Comment Fonctionnent les Liens de Paiement

Fonctionnalites des Liens de Paiement

Support Multi-actifs

Configuration Flexible

Securite et Conformite

Flux de Paiement

1. Creation du Lien de Paiement

2. Pre-remplissage Client avec Parametres de Requete

3. Redirection Post-Paiement

4. Configuration du Montant

4. Traitement du Paiement

5. Reponse de Transaction

Essayez-le

Creation des Liens de Paiement

Lien de Paiement Basique

Lien de Paiement a Montant Variable

Lien de Paiement avec Upload de Fichier

Parametres des Liens de Paiement

Parametres Requis

Parametres Optionnels

Flux de Paiement

Experience Client

Experience Marchand

Evenements Webhook

Exemple de Payload Webhook

Champs Cles des Donnees Webhook

Bonnes Pratiques

Securite

Experience Utilisateur

Integration

Cas d’Utilisation et Exemples

Boutique E-commerce

Facture de Service

Campagne de Dons

Service d’Abonnement

Tests et Developpement

Environnement Sandbox

Test des Webhooks

Support et Ressources

Reference API

Obtenir de l’Aide