- v2 · Recommandé
- v1 · Legacy
En résumé
L’API de Retrait en Fiat de Blockradar convertit les stablecoins pris en charge en fiat et verse les fonds vers des comptes bancaires, du mobile money et d’autres rails locaux. Le flux v2 découvre les méthodes de paiement disponibles pour un corridor, renvoie un schéma décrivant exactement ce dont chaque méthode a besoin, résout des champs tels que le nom du compte du bénéficiaire, puis établit un devis et exécute le retrait depuis une master wallet ou une child address.
L’API de Retrait en Fiat de Blockradar convertit les stablecoins pris en charge en fiat et verse les fonds vers des comptes bancaires, du mobile money et d’autres rails locaux. Le flux v2 découvre les méthodes de paiement disponibles pour un corridor, renvoie un schéma décrivant exactement ce dont chaque méthode a besoin, résout des champs tels que le nom du compte du bénéficiaire, puis établit un devis et exécute le retrait depuis une master wallet ou une child address.

Les méthodes de paiement v2 renvoient un JSON Schema décrivant les informations
sur le bénéficiaire et le paiement que votre application doit collecter. Consultez
Formulaires dynamiques pour afficher, valider, résoudre
et soumettre ces champs. Le flux v1 est disponible dans l’onglet v1 · Legacy,
mais n’est plus recommandé.
Prérequis
Avant d’utiliser le Retrait en Fiat, assurez-vous d’avoir :1
Conformité approuvée
Complétez le processus de Diligence Raisonnable sur le Tableau de bord : My Wallets → Settings → Compliance. Les exigences de conformité et les processus d’approbation varient selon la géographie ; vous n’avez donc besoin de compléter que celles correspondant aux rails locaux utilisés par votre produit.
2
Clé d'API
Obtenez votre clé d’API depuis le Tableau de bord
Blockradar. Allez dans Developers pour
en générer une.
3
Wallet créée
Créez une wallet via le tableau de bord. Vous aurez besoin du
walletId pour les
opérations de retrait.4
Asset ID
Récupérez les actifs fiat pris en charge avec Get Supported
Assets. Utilisez
l’
id renvoyé comme assetId tout au long du flux.Comment cela fonctionne
Le flux v2 est piloté par corridor : vous choisissez un actif, une devise et un montant, puis vous découvrez les méthodes de paiement qui prennent en charge ce corridor et collectez exactement ce que chaque méthode requiert.Découvrir les actifs
Récupérez les stablecoins pris en charge pour les retraits.
Obtenir les devises et les taux
Listez les devises de versement prises en charge et récupérez le taux actuel.
Lister les méthodes de paiement
Découvrez les méthodes disponibles pour l’actif, la devise et le montant.
Obtenir les exigences
Récupérez le JSON Schema décrivant les champs dont la méthode a besoin.
Résoudre et établir un devis
Résolvez des champs comme le nom du compte, puis établissez un devis des frais et du taux.
Exécuter
Soumettez
paymentMethodData pour traiter le retrait.Devises fiat prises en charge
Les devises varient selon le corridor et le fournisseur. Récupérez toujours la liste en direct avec Get Supported Currencies plutôt que de la coder en dur. Le tableau ci-dessous montre les stablecoins et les blockchains que couvre chaque devise prise en charge :Master Wallet vs Child Address
Le Retrait en Fiat est disponible à deux niveaux :Master Wallet
Effectuez des retraits depuis la master wallet. Idéal pour les opérations de trésorerie.
Child Address
Effectuez des retraits depuis une child address spécifique. Utile pour les flux par utilisateur.
Endpoints
Les endpoints de découverte (actifs, devises, taux, méthodes de paiement,
exigences, résolution) sont limités à la master wallet. Une fois que vous
disposez d’un objet
paymentMethodData validé, vous pouvez établir un devis et
exécuter depuis la master wallet ou une child address.Flux typique
- Récupérez les actifs pris en charge pour choisir la stablecoin à retirer.
- Récupérez les devises et le taux pour le corridor choisi.
- Listez les méthodes de paiement pour l’actif, la devise et le montant.
- Obtenez les exigences de la méthode sélectionnée pour recevoir son schéma.
- Résolvez les champs tels que le nom du compte, puis collectez et validez
paymentMethodData. - Obtenez un devis pour afficher les frais et le taux avant l’exécution.
- Exécutez le retrait et suivez le statut avec les webhooks.
Étape 1: Obtenir les actifs pris en charge
Récupérez les stablecoins disponibles pour le retrait et prenez l’id souhaité
comme assetId.Étape 2: Obtenir les devises et le taux
Listez les devises de versement prises en charge, puis récupérez le taux actuel pour l’actif, la devise et le montant.Rate Response
Étape 3: Lister les méthodes de paiement
Découvrez les méthodes de paiement disponibles pour le corridor. Transmettez les mêmesassetId, currency et amount ; affinez éventuellement par country ou
paymentMethodCategory.Payment Methods Response
supportsPaymentMethodResolution: true signifie que le schéma de la méthode peut
inclure un champ x-resolution (comme une recherche de nom de compte) que vous
résolvez avant d’établir le devis. Consultez Étape
5.Étape 4: Obtenir les exigences de la méthode de paiement
Récupérez le JSON Schema qui décrit les champs dont lapaymentMethod
sélectionnée a besoin. Interprétez-le et complétez-le avec Formulaires
dynamiques.Requirements Response
Étape 5: Résoudre les champs et construire paymentMethodData
Collectez les champs dans data.schema. Lorsqu’un champ porte x-resolution
(comme accountName ci-dessus), appelez l’endpoint de résolution une fois que ses
champs dependsOn sont valides, puis stockez le résultat dans ce champ.Resolve Response
paymentMethodData complété ressemble à :Étape 6: Obtenir un devis
Récupérez toujours un devis avant d’exécuter afin de pouvoir afficher le taux, les frais et le délai d’arrivée estimé à l’utilisateur. Envoyez lepaymentMethodData validé.Quote Response
Étape 7: Exécuter le retrait
Une fois que l’utilisateur accepte le devis, exécutez avec les mêmes informations. Ajoutez unereference optionnelle pour l’idempotence et le suivi,
ainsi que metadata et note selon vos besoins.Réponse de l’exécution
Retirer depuis une Child Address
Pour verser depuis une child address spécifique, établissez le devis et exécutez sur les endpoints limités à l’adresse en utilisant les mêmes corps de requête :Webhooks
Suivez le statut du retrait avec les événements webhook suivants :Exemple de payload de webhook
Exemple de flux complet
Une implémentation v2 complète montrant le flux découverte → exigences → résolution → devis → exécution :Réponses d’erreur
Données de méthode de paiement invalides
Données de méthode de paiement invalides
Devise non prise en charge
Devise non prise en charge
Actif non pris en charge
Actif non pris en charge
Fonctionnalité non activée
Fonctionnalité non activée
Solde insuffisant
Solde insuffisant
Solde natif insuffisant
Solde natif insuffisant
Bonnes pratiques
Expérience utilisateur
- Résolvez avant d’établir un devis : Confirmez le nom du compte du bénéficiaire via l’endpoint de résolution avant d’afficher un devis.
- Affichez le coût total : Présentez le taux, les frais de transaction, les frais réseau et le
debitAmount. - Mettez en avant l’état de traitement : Utilisez les webhooks pour mettre à jour les utilisateurs en temps réel.
Exactitude
- Utilisez le schéma renvoyé : Ne collectez que les champs du schéma d’exigences actuel. Ne codez pas en dur les champs du bénéficiaire — consultez Formulaires dynamiques.
- Préservez les chaînes : Envoyez
amountet les identifiants de compte sous forme de chaînes pour éviter toute perte de précision. - Utilisez des références : Suivez les retraits avec une
referenceunique pour des réessais sûrs. - Confirmez via les webhooks : Considérez
offramp.successcomme la source de vérité finale.
Performances
- Mettez en cache les listes d’actifs et de devises : Rafraîchissez périodiquement plutôt qu’à chaque requête.
- Récupérez à nouveau les taux et les méthodes par corridor : Les taux et les méthodes de paiement dépendent de l’actif, de la devise et du montant.
- Réessayez en cas d’erreurs transitoires : Utilisez un backoff exponentiel pour les réponses 5xx.
Référence de l’API
v2 (Recommandé)
Support
- E-mail : [email protected]
- Chat en direct : Disponible sur le tableau de bord

