Comment utiliser Bitfinex Pay pour les commerçants ? (Intégration du paiement)

Présentation de Bitfinex Pay

1. Bitfinex Pay est une solution de traitement des paiements destinée aux commerçants développée par iFinex Inc., la même entité qui exploite Bitfinex et Tether.

2. Il permet aux entreprises d’accepter les paiements en crypto-monnaie directement sur leurs sites Web ou leurs systèmes de point de vente sans exiger que les clients détiennent des comptes d’échange.

3. Le service prend en charge les principales crypto-monnaies, notamment BTC, ETH, USDT et UNUS SED LEO, avec des options de conversion en temps réel en devises fiduciaires.

4. L'intégration s'appuie sur des API RESTful et une architecture de notification basée sur des webhooks pour les mises à jour du statut des commandes et le rapprochement des règlements.

5. Les commerçants doivent effectuer la vérification KYC via le portail d'intégration institutionnel de Bitfinex avant d'accéder aux informations d'identification de production.

Étapes d'intégration technique

1. Les développeurs accèdent au portail des développeurs Bitfinex Pay pour enregistrer une application marchande et obtenir des clés API adaptées à l'initiation du paiement et à la signature du webhook.

2. Une charge utile de facture pré-signée est générée côté serveur à l'aide de HMAC-SHA256 avec la clé secrète du commerçant, intégrant le montant, la devise, l'URL de rappel et l'horodatage d'expiration.

3. La charge utile signée est envoyée via une requête POST à ​​https://pay.bitfinex.com/api/v1/invoice , renvoyant un identifiant de facture unique et des données SVG de code QR.

4. Le commerçant affiche le code QR ou redirige le client vers la page de paiement hébergée à l'aide de l'URL fournie.

5. Une fois la confirmation en chaîne réussie, Bitfinex Pay envoie un HTTP POST au point de terminaison du webhook enregistré contenant un objet JSON avec le statut, le hachage de la transaction et les détails du règlement.

Règlement et réconciliation

1. Les règlements s'effectuent par lots toutes les 6 heures, les fonds étant crédités sur le portefeuille Bitfinex désigné par le commerçant ou sur le compte bancaire externe si la conversion fiduciaire est activée.

2. Chaque règlement comprend un reçu signé cryptographiquement faisant référence à l'identifiant de facture original, à la hauteur du bloc et au montant net après frais de réseau.

3. Les commerçants peuvent interroger les factures historiques à l'aide du point de terminaison /api/v1/invoices avec des filtres de pagination et de plage de dates.

4. Les factures échouées ou expirées déclenchent automatiquement des notifications de webhook avec des codes d'erreur tels que ERR_INVOICE_EXPIRED ou ERR_INSUFFICIENT_CONFIRMATIONS .

5. Les remboursements sont initiés exclusivement via le tableau de bord du commerçant ou via le point de terminaison /api/v1/refund , nécessitant l'ID de facture et le code de motif d'origine.

Protocoles de sécurité

1. Toutes les charges utiles du webhook incluent un en-tête X-BFX-Signature contenant un HMAC codé en base64 du corps brut utilisant le secret partagé du commerçant.

2. La liste blanche des adresses IP est appliquée au niveau du compte ; seules les plages IPv4/IPv6 sur liste blanche peuvent lancer des demandes de création de facture.

3. Les URL de rappel doivent utiliser TLS 1.2+ avec des certificats X.509 valides émis par des autorités de certification de confiance ; les certificats auto-signés sont rejetés.

4. Les charges utiles des factures expirent dans les 15 minutes suivant leur génération, empêchant ainsi les attaques par relecture.

5. Les clés privées utilisées pour la vérification des signatures ne sont jamais transmises sur le réseau et doivent être stockées dans des modules matériels de sécurité (HSM) ou des enclaves sécurisées équivalentes.

Foire aux questions

Q : Bitfinex Pay prend-il en charge les modèles de facturation ou d'abonnement récurrents ? R : Non. Bitfinex Pay est conçu pour le règlement de factures atomiques uniques. La logique récurrente doit être implémentée en externe à l’aide de la génération planifiée de factures.

Q : Les commerçants peuvent-ils désactiver la conversion automatique des devises fiduciaires pendant le règlement ? R : Oui. Les commerçants peuvent configurer la devise de règlement par facture ou globalement via le tableau de bord sous « Préférences de règlement », en conservant les soldes cryptographiques dans les portefeuilles natifs.

Q : Que se passe-t-il si une transaction blockchain est confirmée mais échoue au règlement final en raison d'une liquidité insuffisante ? R : Bitfinex Pay garantit le règlement dès confirmation. Les déficits de liquidité sont résolus en interne par iFinex ; les commerçants reçoivent la pleine valeur quelles que soient les conditions du marché.

Q : Existe-t-il un environnement sandbox pour tester les flux d'intégration ? R : Oui. Le portail des développeurs fournit un point de terminaison intermédiaire sur https://pay-staging.bitfinex.com avec des confirmations de blockchain simulées et des transactions de test sans frais.