Skip to main content
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.
Interface de Retrait en Fiat de Blockradar
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

  1. Récupérez les actifs pris en charge pour choisir la stablecoin à retirer.
  2. Récupérez les devises et le taux pour le corridor choisi.
  3. Listez les méthodes de paiement pour l’actif, la devise et le montant.
  4. Obtenez les exigences de la méthode sélectionnée pour recevoir son schéma.
  5. Résolvez les champs tels que le nom du compte, puis collectez et validez paymentMethodData.
  6. Obtenez un devis pour afficher les frais et le taux avant l’exécution.
  7. 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êmes assetId, 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 la paymentMethod 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
Après résolution et validation, votre 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 le paymentMethodData 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 une reference 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

Pour la configuration des webhooks, la structure du payload et la gestion des événements, consultez la documentation des Webhooks.

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

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 amount et 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 reference unique pour des réessais sûrs.
  • Confirmez via les webhooks : Considérez offramp.success comme 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