API de transfert de bitcoins

V 1.0

Contents

La société Apirone a créée un service entièrement compatible avec Blockchain.info API v1, si populaire auprès d'un large public. Les méthodes fonctionnent exactement de la même façon, possèdent la même structure et les mêmes réponses.

Après que Blockchain.info ait supprimé son API de paiement unique d'origine (v1), de nombreuses boutiques en ligne ont cessées de recevoir des paiements. Nous avons créé notre API de traitement des paiements avec de nouveaux outils et de nouvelles interfaces, puis ajouté des solutions additionnelles pour faciliter la vie des commerçants comme vous. Soyez libre d'utiliser les codes existant sur Blockchain.info API v1 ou les applications utilisées par notre API. Changez simplement l'URL de l'API de base de votre système en remplaçant "blockchain.info" par "apirone.com" et le tour est joué. Vous trouverez également nos nouveaux modules pour le commerce électronique.

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.

Les adresses générées n'ont pas de date d'expiration. Nous les surveillons en permanence.

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.

Comme adresse de destination, vous pouvez indiquer n'importe quelle type d'adresse bitcoin existante: les adresses standards commençant par "1" (P2PKH); les adresses Pay to Script avec le support SegWit (P2SH-P2WPKH), commençant avec "3" de même que les nouvelles adresse Segwit commençant par "bc" (P2WPKH).

 

Requêtes simples:

Exemple de code

<?php
  $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  $my_callback_url = "http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9";
  $api_base = "https://apirone.com/api/v1/receive";
 
  $curl = curl_init();
  curl_setopt_array($curl, array(
      CURLOPT_RETURNTRANSFER =< 1,
      CURLOPT_URL =< $api_base . "?method=create&address=" . $my_address .
		"&callback=" . urlencode($my_callback_url)
  ));
  $response = curl_exec($curl);
  $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  curl_close($curl);
 
  if ($http_status_code == 200) {
      $decoded = json_decode($response, true);
      echo "Please send the payment to the following bitcoin address: " .
			$decoded["input_address"];
  } else {
      echo "Sorry, an error occurred: " . $response;
  }
?>
<?php
  $my_address = "bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4";
  $my_callback_url = 
  		urlencode("http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9");
  $data = file_get_contents("https://apirone.com/api/v1/receive?method=create&address=". 
  		$my_address. "&callback=" . $my_callback_url);
  $respond = json_decode($data,true);
  $address = $respond["input_address"]; // bitcoin address for customer payments
  echo $address;
?>
import requests
import urllib
my_address = 'bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4'
my_callback_url = urllib.parse.urlencode({"r":"http://example.com/callback?invoice_id=1234&secret=7j0ap91o99cxj8k9"})[2:]
url = 'https://apirone.com/api/v1/receive?method=create&address=%s&callback=%s' % (my_address, my_callback_url)
response = requests.get(url)
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:
{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:
{
    "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.