En bref
L’API Retrait Fiat de Blockradar vous permet de convertir des stablecoins pris en charge en monnaie fiduciaire et de transférer des fonds vers des comptes bancaires. Vous pouvez récupérer les actifs pris en charge, valider des comptes bancaires, obtenir des devis et exécuter des retraits depuis des portefeuilles principaux ou des adresses enfants.
L’API Retrait Fiat de Blockradar vous permet de convertir des stablecoins pris en charge en monnaie fiduciaire et de transférer des fonds vers des comptes bancaires. Vous pouvez récupérer les actifs pris en charge, valider des comptes bancaires, obtenir des devis et exécuter des retraits depuis des portefeuilles principaux ou des adresses enfants.

Prérequis
Avant d’utiliser Retrait Fiat, assurez-vous de disposer des éléments suivants :Exigence de conformité
Finalisez l’onboarding partenaire avant de demander l’accès à Retrait Fiat (voir
Exigences de conformité ci-dessous).
Clé API
Obtenez votre clé API depuis le Tableau de bord Blockradar.
Accédez à Developers pour en générer une.
Portefeuille créé
Créez un portefeuille via le tableau de bord. Vous aurez besoin du
walletId
pour les opérations de retrait.ID d'actif
Récupérez les actifs fiat pris en charge via Obtenir les actifs pris en charge.
Fonctionnement
Retrait Fiat suit une séquence simple :Découvrir les actifs
Récupérez les actifs pris en charge pour les retraits.
Obtenir les devises fiat
Récupérez toutes les devises prises en charge.
Obtenir les taux
Récupérez le taux de change actuel pour l’actif sélectionné.
Vérifier le compte
Validez les informations du compte bancaire avant de lancer un retrait.
Obtenir un devis
Estimez les frais et le taux de change pour le montant demandé.
Exécuter
Soumettez le retrait au traitement.
Exigences de conformité
Avant d’accéder à Retrait Fiat, finalisez le processus d’onboarding conformité adapté à la couverture de devise de paiement souhaitée.Choisissez votre parcours d’onboarding
- NGN (Naira) uniquement : Complétez le formulaire d’onboarding Naira uniquement.
- Autres devises africaines : Complétez l’onboarding partenaire pour devises africaines.
Si vous avez besoin d’un accès à la fois au NGN et à d’autres devises africaines prises en charge, complétez les deux parcours d’onboarding.
Exigence d’approbation
L’accès à Retrait Fiat est activé après revue de conformité et approbation pour le parcours d’onboarding sélectionné.Portefeuille principal vs adresse enfant
Retrait Fiat est disponible à deux niveaux :Portefeuille principal
Retirez depuis le portefeuille principal. Idéal pour les opérations de trésorerie.
Adresse enfant
Retirez depuis une adresse enfant spécifique. Utile pour les flux par utilisateur.
Endpoints
| Opération | Portefeuille principal | Adresse enfant |
|---|---|---|
| Obtenir les actifs pris en charge | GET /v1/wallets/{walletId}/withdraw/fiat/assets | — |
| Obtenir les institutions | GET /v1/wallets/{walletId}/withdraw/fiat/institutions | — |
| Obtenir les taux de change | GET /v1/wallets/{walletId}/withdraw/fiat/rates | — |
| Obtenir les devises | GET /v1/wallets/{walletId}/withdraw/fiat/currencies | — |
| Vérifier le compte de l’institution | POST /v1/wallets/{walletId}/withdraw/fiat/institution-account-verification | — |
| Obtenir un devis | POST /v1/wallets/{walletId}/withdraw/fiat/quote | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/quote |
| Exécuter | POST /v1/wallets/{walletId}/withdraw/fiat/execute | POST /v1/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute |
Flux type
- Récupérez les actifs pris en charge pour choisir le stablecoin à retirer.
- Listez les institutions et sélectionnez un identifiant de banque/institution.
- Vérifiez le compte pour confirmer le nom et les informations du compte.
- Obtenez un devis pour afficher frais et taux avant exécution.
- Exécutez le retrait et suivez son statut dans votre système.
Étape 1 : Obtenir un devis
Récupérez toujours un devis avant d’exécuter un retrait afin d’afficher le taux et les frais à l’utilisateur.Paramètres de la requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
assetId | string | Oui | ID de l’actif stablecoin à retirer |
amount | number | Oui | Montant à retirer dans l’unité de l’actif |
currency | string | Oui | Devise fiat de destination (ex. NGN) |
accountIdentifier | string | Oui | Numéro de compte bancaire ou identifiant |
institutionIdentifier | string | Oui | Code de la banque/institution |
Exemple de devis
Étape 2 : Exécuter le retrait
Une fois le devis accepté, exécutez le retrait avec les mêmes informations (et tout code/OTP requis).Paramètres de la requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
assetId | string | Oui | ID de l’actif stablecoin à retirer |
amount | number | Oui | Montant à retirer dans l’unité de l’actif |
currency | string | Oui | Devise fiat de destination (ex. NGN) |
accountIdentifier | string | Oui | Numéro de compte bancaire ou identifiant |
institutionIdentifier | string | Oui | Code de la banque/institution |
code | string | Non | Code de vérification si requis par le fournisseur |
Exemple d’exécution
Réponse d’exécution
Webhooks
Suivez l’état du retrait avec les événements webhook suivants :| Événement | Description |
|---|---|
offramp.processing | Le retrait est en cours de traitement |
offramp.success | Le retrait a été effectué avec succès |
offramp.failed | Le retrait a échoué |
Exemple de payload webhook
Exemple de flux complet
Voici une implémentation complète du flux vérifier → devis → exécuter :Réponses d’erreur
Informations bancaires invalides
Informations bancaires 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
Solde du portefeuille principal insuffisant
Solde du portefeuille principal insuffisant
Bonnes pratiques
Expérience utilisateur
- Vérifiez les comptes en premier : Confirmez toujours le nom du compte avant d’afficher un devis
- Affichez le coût complet : Présentez le taux de change, les frais réseau et le montant total
- Exposez l’état de traitement : Utilisez les webhooks pour informer les utilisateurs en temps réel
Sécurité
- Validez les entrées : Assurez-vous que la devise, l’institution et les identifiants de compte sont bien formés
- Utilisez des références : Suivez les retraits avec une
referenceunique - Confirmez via webhooks : Considérez
offramp.successcomme source finale de vérité
Performance
- Mettez en cache les listes d’institutions : Rafraîchissez-les périodiquement plutôt qu’à chaque requête
- Réutilisez les métadonnées d’actifs : Mettez en cache actifs et devises pris en charge
- Réessayez en cas d’erreurs transitoires : Utilisez un backoff exponentiel pour les réponses 5xx
Référence API
| Endpoint | Description |
|---|---|
| Obtenir les actifs pris en charge | Liste les stablecoins pris en charge |
| Obtenir les institutions | Liste les institutions par devise |
| Obtenir les taux de change | Récupère le taux de change pour un devis |
| Obtenir les devises | Liste les devises fiat prises en charge |
| Vérifier le compte de l’institution | Vérifie les informations du compte bancaire |
| Devis portefeuille principal | Obtient un devis depuis le portefeuille principal |
| Exécution portefeuille principal | Exécute un retrait depuis le portefeuille principal |
| Devis adresse enfant | Obtient un devis depuis une adresse enfant |
| Exécution adresse enfant | Exécute un retrait depuis une adresse enfant |
Support
- Email : [email protected]
- Documentation : Référence API

