Adresse

V 2.0

Cette fonction génère une adresse bitcoin unique permettant à chaque client de régler ses paiements. Cette adresse ne comporte pas de date d'expiration et fonctionne sans limite de transaction.

Contents

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.

Callback

Pour tous les types de portefeuilles, vous recevrez des callbacks pour chaque transaction confirmée. Cependant, les méthodes et le format diffèrent selon que vous utilisiez l'API V1 ou V2.Merci de lire la documentation à ce sujet.
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.

 

Requêtes simples:

{
   "callback":{                    #Les données de callback sont facultatives
      "url",
      "data":{
         "invoice_id": 1234,
         "secret": "7j0ap91o99cxj8k9",
         "data3": "text3",
		 ... #any user parameters
      }
   }
}

Exemple de code

Wallet ID
Callback URL KeyValue

+

{
   "callback":{
      "url" :  "http://example.com/callback"
   }
}
  
<?php
  $json_data = array (
    "callback" => array(
        'url'=> 'http://example.com/callback',
		'data'=> array (
            'invoice_id'=> "1234",
            'secret'=> "7j0ap91o99cxj8k9"
        )
    )
  );
  
  $wallet = "1aee83487b65b690305201fb4b42a081";
  $api_base = "https://apirone.com/api/v2/btc/wallet/". $wallet ."/address";
 
  $curl = curl_init($api_base);
  curl_setopt($curl, CURLOPT_HTTPHEADER, array("Content-Type: application/json"));
  curl_setopt($curl, CURLOPT_POST, 1);
  curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($json_data));
  curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
  $http_status_code = curl_getinfo($curl, CURLINFO_HTTP_CODE);
  $response = curl_exec($curl);
  curl_close($curl);
 

  $decoded = json_decode($response, true);
  echo "Please send the payment to the following bitcoin address: " .
  $decoded["address"];
?>
Envoyer une requête
Réponse du serveur:

JSON Description du schéma

Utiliser une requête POST contenant un objet au format JSON.

Callback URL

Le callback est un tableau d'URL de rappel et de paramètres de données d'utilisateurs.

Paramètres Description Obligatoire
{callback:url}
string,
=< 1024 chars

Callback URL
L'adresse URL de votre serveur reçoit les données relatives au paiement. L'adresse URL indiquée doit obligatoirement être valide.

Obligatoire
{callback:data}
tableau

Données
Le tableau associatif est basé sur des paires de valeur-clé. Vous pouvez l'utiliser comme un identificateur supplémentaire ou dans le but de sécuriser une adresse bitcoin générée.

Par exemple 'secret' = '7j0ap91o99cxj8k9' or 'invoice_id'='1234'

Facultatif

Exécution réussie

En cas de succès, la requête renvoie quatre paramètres au format JSON:
Paramètres Description Type (longeur)
{address} L'adresse bitcoin générée pour recevoir le paiement d'un client. string, 32 chars
{callback} L'URL de rappel de votre serveur pour recevoir les données relatives au paiement. string, max. 1024 chars
Exemple de réponse:
{
   "callback":{
      "url":"http://example.com/callback",
      "data":{
         "invoice_id":1234,
         "secret":"7j0ap91o99cxj8k9"
      }
   },
   "address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z",
   "type": "p2sh-p2wpkh",
   "currency": "btc"
}

Message d'erreur

La réponse d'erreur retourne un message dans le format texte ci dessous:
Portefeuille invalide.
Le nombre d'adresses indiqué dépasse la limite autorisée.
Toutes les destinations doivent être uniques.
Impossible de décoder l'objet JSON: Valeur souhaitée: ligne 1 colonne 64 (char 63)
Callback invalide. Le callback doit contenir uniquement une adresse URL valide et des données facultatives.