Français
English
explorer.cash explorer.cash

Présentation

Découvrez comment intégrer explorer.cash dans votre application, site web ou boutique pour accepter les crypto monnaies directement sur votre portefeuille.

Pré-requis

Tout d'abord, vous devez soucrire à l'un de nos packs pour cryptos. Lors de la souscription, vous devez renseigner l'URL du site web qui sera utilisé pour accepter les crypto monnaies.

URL de l'API en mode production :

https://api.explorer.cash

URL de l'API en mode test :

https://api.explorer.cash/testing

Toutes les réponses sont renvoyés au format JSON.

Requête de paiement

Pour vérifier le paiement d'une transaction en crypto monnaie, vous allez dans un permier temps envoyer une requête de paiement.

URL du service :

POST https://api.explorer.cash/paymentrequests

Liste des paramètres supportés :
ParamètreObligatoireDescription
callback_urlL'URL de votre application qui sera appelée lors du paiement
payment_referenceVotre référence de paiement (ex : ID de la commande)
timeoutLa fenêtre de temps pour le paiement exprimée en minutes
confirmationsLe nombre de confirmations pour considérer une transaction comme valide
unitL'unité de la crypto monnaie (ex : BTC, BCH, USDT, USDC, ...)
addressL'adresse de votre wallet pour la crypto monnaie utilisée
address_tagTag pour les crypto monnaies supportant cette fonctionnalité (ex : XRP)
amountLe montant du paiement dans la crypto définie dans "unit"
conversion_rateLe taux de conversion utilisé

Ce service retourne l'ID du paiement :

{
"payment_id": "0wyQBvivK1shkoBLctlvM5zQnKGxcgvOIBKVgtoJFoo="
}

Validation du paiement

Lorsque le paiement est détecté dans la blockchain liée à la crypto monnaie utilisée, une notification de paiement est envoyée à l'URL que vous avez indiqué dans la requête de paiement (paramètre callback_url) :

{
"payment_id": "0wyQBvivK1shkoBLctlvM5zQnKGxcgvOIBKVgtoJFoo=",
"payment_reference": 3560,
"tx_hash": "aba3c7c17634e2e9708fb2c38adab78d119885d7719e46ace762032465a64fbd",
"unit": "BTC"
"address": "1EfARsRNXC3DG1ZF1PesbyVNLE1jEHcKDi",
"amount": 0.06538985,
"amount_left": 0,
"status": "WAITING"
...
}

Liste des données envoyées au format JSON :

ChampDescription
payment_id

ID de paiement. Utilisez ce champ pour vérifier que celui-ci correspond à celui que vous avez reçu lors de la création de la requête de paiement.

payment_referenceVotre référence de paiement (ex : ID de la commande)
tx_hashL'ID de la transaction dans la blockchain
amount_leftMontant restant à payé
status

Status du paiement : PENDING, WAITING ou PAID

PENDING :
Le paiement a été effectué mais le client n'a pas payé le montant total. Le montant restant est disponible dans le champ amount_left.

WAITING :
Le paiement a été effectué en totalité. Le paiement sera validé dès que le nombre de confirmations renseigné dans la requête de paiement est atteint.
PAID :
Le paiement est confirmé.

Veuillez également noter que les autres champs fournis lors de la création de la requête de paiement sont également injectés dans les données envoyées comme unit, address, conversion_rate, ...

Taux de change

Vous pouvez souscrire à ce service, pour recevoir toutes les 5 minutes le taux de change des crypto monnaies dans votre devise. Toutes les devises mondiales sont supportées.

Pour utiliser ce service, vous devez souscrire au pack : Pro Plus.

URL du service :

POST https://api.explorer.cash/rates

Liste des paramètres supportés :
ParamètreObligatoireDescription
callback_urlL'URL de votre application qui sera appelée lors de la mise à jour des taux de change
currencyVotre devise (ex : USD, EUR, ...).

Ce service retourne le taux de change des crypto monnaies dans votre devise :

{
"BTC": 9315.68,
"ETH": 270.42,
"XRP": 0.207253,
"USDT": 0.850194,
"BCH": 241.9,
"ADA": 0.11763,
"BSV": 179.12
....
"BTT": 0.00032235,
"ALEND": 0.294445
}

Bibliothèques

Retrouvez nos bibliothèques pour la mise en place de notre API de paiement Blockchain dans votre propres projets :

PHP : explorer.cash API pour PHP

Haut