API de transfert de bitcoins

Contents

Cette fonction génère une adresse bitcoin unique qui permettra au client d'effectuer son paiement. Cette adresse sera toujours surveillée et ne comporte aucune limite de transactions.

Vous pouvez générer des adresses bitcoin pour un paiement unique ou pour des paiements périodiques en tant qu'adresse bitcoin reliée à un compte utilisateur. Par exemple, si un client souhaite la réutiliser pour acheter le même produit ou pour recharger le solde de son compte avec des bitcoins.

Veuillez noter que les micropaiements ne sont pas rentables sur le réseau bitcoin en raison de frais excessivement élevés.

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.

 

Example of Pay2KeyHash addresses:

Example of ScryptSig addresses:

 

Example of SegWit addresses:

 

Requêtes simples:

Exemple de code

  1. <?php
  2.     $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  3.     $my_callback_url = "http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9";
  4.     $api_base = "https://apirone.com/api/v1/receive";
  5.  
  6.     $curl = curl_init();
  7.     curl_setopt_array($curl, array(
  8.         CURLOPT_RETURNTRANSFER => 1,
  9.         CURLOPT_URL => $api_base . "?method=create&address=" . $my_address . "&callback=" . urlencode($my_callback_url)
  10.     ));
  11.     $response = curl_exec($curl);
  12.     $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  13.     curl_close($curl);
  14.  
  15.     if ($http_status_code == 200) {
  16.         $decoded = json_decode($response, true);
  17.         echo "Please send the payment to the following bitcoin address: " . $decoded["input_address"];
  18.     } else {
  19.         echo "Sorry, an error occurred: " . $response;
  20.     }
  21. ?>
  1. <?php
  2.   $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  3.   $my_callback_url = urlencode("http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9");
  4.   $data = file_get_contents("https://apirone.com/api/v1/receive?method=create&address=". $my_address. "&callback=" . $my_callback_url);
  5.   $respond = json_decode($data,true);
  6.   $address = $respond["input_address"]; // bitcoin address for customer payments
  7.   echo $address;
  8. ?>
  1. import requests
  2. import urllib
  3. my_address = 'bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4'
  4. my_callback_url = urllib.parse.urlencode({"r":"http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9"})[2:]
  5. url = 'https://apirone.com/api/v1/receive?method=create&address=%s&callback=%s' % (my_address, my_callback_url)
  6. response = requests.get(url)
  7. print(response.text)
Méthode et variables:
Paramètres Description Obligatoire Expérience avec une valeur
method=create

Cette méthode génère de nouvelles adresses de dépôt

Obligatoire
{address}
base58,
32 caractères

Adresse de destination
Votre adresse de destination vers laquelle les paiements confirmés seront transférés

Obligatoire
{callback}
texte,
=< 1024 caractères

Callback URL')}}
L'URL de rappel de votre serveur pour recevoir les données relatives au paiement. Vous pouvez ajouter n'importe quel paramètre GET facultatif. Ce doit être une URL valide.
Le lien doit être au format URL ou doit être attaché à la fin de la demande. Si ce n'est pas le cas, il vous sera retourné un message d'erreur.

Obligatoire
  Effacer Envoyer une requête
Réponse du serveur:
{ "fee_percent": 1, "destination": "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4", "input_address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z", "callback_url": "http://example.com/addbalance.php?user=118" }

Exécution réussie

En cas de succès, la requête renvoie quatre paramètres au format JSON:
Paramètres Description Type (longeur)
{fee_percent} Le pourcentage qui est pris en tant que frais de service. Défaut: 1 nombre entier
{destination} L'adresse bitcoin du magasin où les paiements confirmés seront transférés base58 (32 caractères)
{input_address} L'adresse bitcoin générée pour recevoir le paiement d'un client. base58 (32 caractères)
{callback_url} L'URL de rappel de votre serveur pour recevoir les données relatives au paiement. texte (maximum 1024 caractères)
Exemple de réponse:
{
    "fee_percent": 1,
    "destination": "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4",
    "input_address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z",
    "callback_url": "http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9"
}

Message d'erreur

La réponse d'erreur retourne un message dans le format texte ci dessous:
The supplied address is not a valid bitcoin address. - L'adresse fournie n'est pas une adresse bitcoin valide.
The supplied callback URL is not valid. - L'URL de rappel fournie n'est pas valide.
Wrong method. - Mauvaise méthode.
Not enough parameters. - Pas suffisamment de paramètres.
Incorrect address type.