Адрес

Функция создает новые биткойн или лайткоин адреса для приема платежей от клиентов. Этот адрес бессрочный и не имеет каких либо ограничений.

Contents

Вы можете генерировать новый биткоин или лайткоин адрес под каждый отдельный платеж или использовать этот адрес как привязанный к клиенту, например для пополнения баланса аккаунта клиента на своем сайте. То есть в том случае, если клиент использует этот адрес для повторной покупки одного и того же товара или ему нужно пополнить баланс своего аккаунта.

Запрос:

JSON Описание схемы

Используйте метод POST для отправки объектов в JSON формате

{WalletID} Идентификатор Кошелька Обязательное поле
Ссылка на страницу колбэка

Колбэк это массив из URL и данных пользователя

{callback:url}
string,
=< 1024 chars

Ссылка на страницу колбэка
URL-адрес колбэка для получения данных об оплате. URL-адрес должен быть валидным.

Опциональное поле
{callback:data}
массив

Данные
Ассоциативный массив состоящий из пар ключ-значение. Здесь вы можете использовать дополнительные идентификаторы или секретные поля для большей безопасности.

Для примера 'secret' = '7j0ap91o99cxj8k9' or 'invoice_id'='1234'

Опциональное поле

Пример запроса:
{
   "callback":{                    #Данные для колбэка и сам колбэк являются опциональными полями
      "url",
      "data":{
         "invoice_id": 1234,
         "secret": "7j0ap91o99cxj8k9",
         "data3": "text3",
		 ... #any user parameters
      }
   }
}

Успешный ответ сервера:

При успешном выполнении, запрос возвращает следующие параметра в JSON-формате:
{address} Сгенерированный биткоин-адрес для оплаты покупателем. string, 32 chars
{callback} Ссылка на страницу колбэка вашего интернет-магазина. string, max. 1024 chars
{type} Тип адреса. string
{currency} Криптовалюта: btc, ltc string
Пример результата выполнения:
{
   "callback":{
      "url":"http://example.com/callback",
      "data":{
         "invoice_id":1234,
         "secret":"7j0ap91o99cxj8k9"
      }
   },
   "address": "1FEGJSLDJJ6oSuJwur3fCD7TtQbYUjBV4z",
   "type": "p2sh-p2wpkh",
   "currency": "btc"
}

Сообщение об ошибке

Примеры кода и тестовая площадка:

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/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"];
?>
Сделать запрос
Результат выполнения: