Adresse

This function generates an unique bitcoin address to which the customer may send payments. This address works without an expiry date or transaction limit.

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.

Request:

JSON Description du schéma

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

{WalletID} Wallet Identificator Obligatoire
Callback URL

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

{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.

Facultatif
{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

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

Success Response Reference:

Success response returns next parameters in JSON format:
{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

Playground and Code examples:

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: