Passer au contenu principal
En bref
Votre client paie sur un compte virtuel par virement bancaire. Blockradar règle le paiement en stablecoin sur votre portefeuille et envoie onramp.success. Votre gestionnaire de webhooks verse ensuite le montant en devise locale avec Retrait en Fiat. Ni votre client ni le bénéficiaire n’ont à voir ou à détenir la stablecoin.
Ce guide prend le naira (NGN) comme exemple : un compte virtuel en NGN réglé en USDC sur Base, et un paiement en NGN vers un compte bancaire nigérian. Le même flux fonctionne pour toute devise qui prend en charge les dépôts et les paiements.

Prérequis

  • Une approbation de conformité pour les corridors que vous utilisez, côté dépôt comme côté paiement. Consultez la FAQ pour savoir ce qu’implique la vérification de l’entreprise.
  • Les comptes virtuels activés sur votre compte. Consultez les prérequis des Comptes Virtuels.
  • Un endpoint de webhooks qui vérifie les signatures. Consultez Webhooks.

Fonctionnement

1

Créez un compte virtuel

Créez un compte virtuel sur votre portefeuille avec NGN comme devise et USDC comme actif de destination. Suivez les étapes 1 à 3 des Comptes Virtuels.
2

Votre client paie par virement bancaire

Communiquez le numéro de compte à votre client. À l’arrivée de son virement, Blockradar envoie onramp.processing, puis règle l’USDC sur votre portefeuille et envoie onramp.success.
3

Payez à la réception de onramp.success

Votre gestionnaire de webhooks trouve l’actif Retrait en Fiat correspondant à la stablecoin réglée, puis obtient un taux, demande un devis et exécute un paiement en NGN. Suivez les étapes 1 à 7 de Retrait en Fiat.
4

Confirmez le paiement

Retrait en Fiat envoie ses propres webhooks à mesure que le paiement progresse. Consultez les webhooks de Retrait en Fiat.

Le webhook onramp.success

Les champs nécessaires au paiement sont toCurrency (la stablecoin réglée), toAmount (le montant réglé) et wallet.id (le portefeuille crédité) :
Utilisez data.id pour traiter chaque événement une seule fois. Un même événement peut être livré plusieurs fois.

Lancer le paiement depuis le webhook

Si le compte virtuel est réglé en cNGN

Un compte virtuel peut être réglé en cNGN au lieu d’USDC, si ses options de découverte le proposent. Le cNGN se paie uniquement en NGN. Pour verser du cNGN dans une autre devise, effectuez d’abord un swap vers l’USDC. Consultez Swap avant le paiement.

Voir aussi