← Blog
10 min de lecture
|
Publié le
|
Mis à jour le

API blockchain pour la finance : ce qu'elle fait

Ce que fait une API blockchain pour les équipes paiement et finance : portefeuilles, transferts, webhooks de dépôt, et ce qu'elle ne couvre pas (KYC, rapports).

Chapitres
C
Chaingateway Team
Experts blockchain

Relu par Maurice Sobiera

Une API blockchain pour la finance est une interface REST qui permet au backend d’une entreprise de créer des portefeuilles, d’envoyer des transactions et de recevoir des notifications de dépôt sur des blockchains publiques, sans exploiter ses propres nœuds. Chaingateway la propose pour Bitcoin, Ethereum, BNB Smart Chain, Tron, Solana, Polygon et Arbitrum. Elle déplace de la valeur sur la chaîne. Elle ne remplace pas les processus de conformité.

Quel problème financier une API blockchain peut-elle traiter ?

Une API blockchain traite le côté technique du déplacement de valeur sur la chaîne : portefeuilles, transferts et confirmation des paiements entrants. Les paiements transfrontaliers en sont une motivation typique. Le Conseil de stabilité financière (FSB) décrit les objectifs que le G20 leur a fixés dans son rapport de feuille de route.

SegmentObjectif de coûtObjectif de rapidité (d’ici fin 2027)
Paiements de détailCoût moyen d’au plus 1 %, aucun corridor au-dessus de 3 %, d’ici fin 202775 % des paiements disponibles pour le bénéficiaire en moins d’une heure
Transferts de fonds des migrantsCoût moyen d’envoi de 200 $ d’au plus 3 % d’ici 2030, aucun corridor au-dessus de 5 %75 % des paiements disponibles en moins d’une heure
Gros montants (wholesale)Aucun objectif fixé75 % crédités en moins d’une heure

Un transfert sur la chaîne est une manière technique de se rapprocher des objectifs de rapidité, car une transaction confirmée se règle entre les deux portefeuilles sans banques intermédiaires. Les objectifs de coût dépendent de plus que du transfert. Les frais de réseau, la conversion depuis et vers la monnaie locale et l’agrément des parties concernées comptent aussi. Une API n’en supprime aucun. Considérez toute promesse d’économies comme une valeur à mesurer dans votre propre flux.

Que fait l’API ?

L’API Chaingateway couvre les étapes d’un flux de paiement sur la chaîne par des points d’accès HTTP. Vous vous authentifiez avec un jeton bearer, et un en-tête de requête choisit le mainnet ou le testnet.

  • Créer et gérer des adresses, par exemple POST /api/v2/ethereum/addresses, et lire les soldes.
  • Envoyer des monnaies natives et des jetons, par exemple POST /api/v2/tron/transactions/trc20 ou les points d’accès ERC-20.
  • Lire les transactions et les reçus.
  • Enregistrer des webhooks qui notifient votre point d’accès quand une adresse surveillée reçoit une transaction.

Les webhooks sont disponibles sur Bitcoin, Ethereum, BNB Smart Chain, Tron, Polygon et Arbitrum. Solana n’a pas de webhooks : vous y détectez les dépôts en interrogeant les transactions. Les notifications de webhook ne sont pas renvoyées automatiquement. Les notifications échouées sont listées et vous pouvez demander leur renvoi : votre système doit donc aussi se rapprocher de l’API. L’article sur les garanties de livraison des webhooks explique comment concevoir en tenant compte de cela.

Chaingateway est non custodial : le service ne détient pas vos fonds.

À quoi ressemble un flux de paiement de bout en bout ?

Un flux de dépôt comporte cinq étapes, et chacune correspond à un appel d’API.

  1. Créez une adresse pour le client ou la commande avec POST /api/v2/{chain}/addresses. Sur Bitcoin, la ressource s’appelle wallets.
  2. Enregistrez un webhook pour cette adresse avec POST /api/v2/{chain}/webhooks, avant que le client paie.
  3. Recevez la notification sur votre point d’accès et vérifiez son en-tête X-Signature.
  4. Confirmez la transaction auprès de l’API et créditez la commande après un nombre suffisant de confirmations.
  5. Déplacez les fonds vers votre propre portefeuille de trésorerie avec un point d’accès de transfert, par exemple POST /api/v2/ethereum/transactions/erc20.

Le tableau montre où ce flux est disponible. Le segment de chemin {chain} vaut bitcoin, ethereum, bsc, tron, polygon, arbitrum ou solana.

RéseauAdresses et transfertsWebhooks
BitcoinOuiOui
EthereumOuiOui
BNB Smart ChainOuiOui
TronOuiOui
PolygonOuiOui
ArbitrumOuiOui
SolanaOuiNon

Une API blockchain gère-t-elle la conformité ?

Non. Une API n’effectue ni KYC, ni filtrage des sanctions, ni déclarations réglementaires. Ces obligations restent à la charge de l’entreprise qui propose le service, et leur application dépend de son modèle d’activité et de sa juridiction. Notre article sur le KYC des paiements crypto décrit les contrôles à régler avant d’intégrer.

Ce que la chaîne fournit, c’est un enregistrement. L’Institut national américain des normes et de la technologie (NIST) explique dans le NISTIR 8202 que les utilisateurs de Bitcoin sont pseudonymes : la personne derrière un compte n’est pas nommée, mais les identifiants de compte sont visibles et toutes les transactions sont publiques. Vos enregistrements peuvent renvoyer à des hachages de transaction que chacun peut vérifier. Relier une adresse à un client incombe à votre propre processus d’accueil des clients.

Le NIST indique aussi que les blockchains sont infalsifiables dans le sens où toute altération est visible et difficile, mais pas complètement immuables. Les blocs les plus récents peuvent être remplacés par une chaîne concurrente plus longue. C’est pourquoi la plupart des utilisateurs attendent plusieurs confirmations de blocs avant de considérer un paiement comme définitif. Fixez le nombre de confirmations qu’exige votre politique de risque, et ne créditez les clients qu’après ce seuil.

Comment commencer ?

Commencez sur un testnet. Ajoutez l’en-tête X-Network: testnet à vos requêtes pour utiliser les réseaux de test, créez une adresse, envoyez un petit transfert et enregistrez un webhook pour voir arriver une notification. Chaingateway propose un essai gratuit de 7 jours, sans carte bancaire ni vérification d’identité pour commencer. Les offres payantes démarrent à 49 € par mois, ou 490 € par an.

Pour un plan de construction concret, lisez comment créer un portefeuille crypto avec une API et comment fonctionnent les webhooks de paiement crypto.

Comment nous rédigeons ces articles

Prêt à le construire vous-même ? Obtenir votre clé API — essai de 7 jours, sans carte bancaire — ou consultez API Blockchain pour la référence complète des endpoints.

C
Chaingateway Team
Experts blockchain

L'équipe Chaingateway s'attache à simplifier l'intégration blockchain pour les développeurs du monde entier.