Recevoir des rappels

V 2.0

Contents

Lorsque notre système détecte un paiement, notre serveur vous envoie une notification contenant toutes les informations importantes relatives à votre paiement. Vous devrez ensuite créer une page de traitement des paiements pour gérer les rappels et finaliser les commandes de vos clients.

Notre service émet des notifications entre 0 (une nouvelle transaction non confirmée dans le réseau bitcoin) et 6 confirmations. Vous pourrez cependant recevoir 7 rappel pour chaque transaction.

Après 1confirmation, vous recevrez vos bitcoins à l'adresse de destination, puis une transaction hash et une adresse de destination seront ajoutés aux paramètres de rappel.

Afin de confirmer le traitement réussi de notre rappel, votre serveur doit répondre par un message texte au format standard:

*ok*

Lorsque nous recevons *ok* nous arrêterons les rappels pour cette transaction.

Au cas ou votre serveur ne répondrait pas ou répondrait de manière incorrecte, notre serveur effectuera de nouvelles tentatives pour chaque nouveau bloc durant 3 jours.

La différence entre le Callback V1 et V2 réside dans le type de requête (GET / POST) et dans la construction des paramètres JSON. Si vous utilisez le processeur V2, veuillez utiliser les callbacks destinés à la version V2!

Dans cette version, les callbacks sont toujours envoyés à l'adresse URL envoyés en tant que requête POST et contenant les détails de la transaction transférée.

Cloud Flare callbackPlease add our domain and source IP to the white list in Cloudflare CDN dashboard.
Otherwise, we can not guaranty properly callback to your host.

Les schémas de protocole HTTP et HTTPS sont requis dans votre URL. Nous supportons également les rappels vers le réseau TOR project logo réseau.

Paramètres et variables

Le tableau suivant répertorie tous les paramètres POST qui seront envoyés dans la requête au serveur:

Paramètres Description Eléments requis Expérience avec une valeur
{data} Tableau des paramètres utilisateurs pour le paiement Facultatif  
{value}
nombre entier, plage 1-10^16

Somme en Satoshi
Le montant en bitcoin est envoyé par le client en Satoshi (1 BTC = 100.000.000 Satoshi). Assurez vous que vous les avez parfaitement convertis en BTC, et si nécessaire, divisez les par 100.000.000.

Toujours
{input_address}
string, 32 caractères
Adresse d'entrée
L'adresse bitcoin générée à laquelle le client a envoyé le paiement.
Toujours
confirmations
nombre entier, plage 0-1000

Confirmations
Le nombre de confirmations accepté. Entre 0 et 6.

Toujours
{input_transaction_hash}
texte, 64 caractères

Transaction hash d'entrée
Hash de la transaction du client.

Toujours
  Effacer Essai
Réponse du serveur:
*ok*

Mauvaise réponse. Le message indiquant une exécution réussie du processus doit être écrite dans un format texte standard sans aucun autre symbole ou caractère. Bonne réponse: *ok*

Bonne réponse: Merci.
Exemple de rappel

Le bloc suivant présente un exemple de callback:

{
  "data": 
  {
      "invoice_id": 1234,
      "secret": "7j0ap91o99cxj8k9"
  },
  "input_address": "1E2VSRsaW3Kb1gDkdRUGDo6knAKfi9iYsb",
  "confirmations": 1,
  "input_transaction_hash": "4a5e1e4baab89f3a32518a88c31bc87f618f76673e2cc77ab2127b7afdeda33b",
  "value" : 100000000
}

Callback reçu - Exemple de code

Ne clôturez pas votre commande avec 0 confirmation! En effet, le client peut créer une nouvelle transaction comprenant des frais de transaction plus élevés vers un autre destinataire. Si cette dernière est confirmée par le réseau, votre paiement n'arrivera jamais. Vous devez mettre à jour votre commande et attendre les confirmations.

Terminez votre commande ou recharger le compte d'un utilisateur uniquement avec une transaction confirmée et après 3 confirmations (nombre recommandé) . Ainsi vous serez certain que chaque paiement parviendra jusqu'à vous. Comme le montre le second exemple en language PHP.