Кошелек для Форвардинга

V 2.0

Bitcoin QR code icon

Contents

Форвардинг кошелек принимает и сразу же пересылает деньги на ваш биткоин-адрес. Так же в нем есть возможность разделять входящую транзакцию на несколько выплат.

Входящая оплата может быть разделена по списку до 255 получателей. Вы можете отправлять как фиксированные суммы так и процент от оплаты. Эта функция очень удобна для мгновенных рассчетов с рефералами, разделения выплат в многоуровневом маркетинге, выплата гонарара или разделение на горячий и холодный кошелек. Если после деления платежа, остается остаток, то он направляется на последний адрес из списка. Вы можете создавать сколь угодно таких кошельков для своего проекта.

Каждый платеж делиться по очереди, в списке, пока не распределиться вся сумма до последнего Сатоши. Список выполняется от первого и до последнего значения. Поэтому порядок важен.

Запрос:

JSON Описание параметров запроса

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

{type} Тип кошелька: накопительный или форвардинг. Обязательное поле
Ссылка на страницу колбэка

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

{callback:url}
string,
=< 1024 chars

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

Обязательное поле
{callback:data}
массив

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

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

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

Биткоин-адрес получателя и сумма

Ваш биткоин-адрес для получения платежа. Можете указать минимум 1, максимум 255 различных биткоин-адресов. Тогда входящая оплата разделиться согласно этому списку.

Параметры Описание Обязательное поле Пример
{destinations}
string,
32 - 42 chars
Биткоин-адрес получателя

Биткоин-адрес Интернет-магазина, куда будет произведён форвардинг платежа.

Обязательное поле

1apiKcJM95jENZeom2dQo8ShK7dUQkRaS

bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4

{amount}
(integer | "percent in string")

Сумма

Сумма в Сатоши или в процентах. Если этот параметр пустой, то вся оставшаяся сумма будет переведена на этот адрес.

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

253999

"20%"

"31.55%"

Пример запроса:
{
"type": "forwarding",
"callback":{                       #optional
      "url": "your_callback_URL",  #optional
      "data":{                     #optional
         "optional_key": "value"
      }
   },
	"destinations":[           #Адрес получателя указывается только для Форвардинг-кошельков
      {"amount": <amount|"percents">, "address": "<bitcoin_address>"},
		... #from 1 to 255 addresses
	]
}

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

{wallet}
string
Идентификатор кошелька. Кошелек содержит множество биткоин-адресов. Обязательное поле
{transfer_key}
string
Ключ для перевода средств (выплаты). Обязательное поле
{type}
string
Тип кошелька: накопительный или форвардинг. Обязательное поле
{currency}
string
Тип криптовалюты: btc. Обязательное поле
{callback}
array
Колбэк это массив из URL и данных пользователя. Опциональное поле
{destinations} Биткоин-адрес Интернет-магазина, куда будет произведён форвардинг платежа. Обязательное поле
Пример результата выполнения:

{
  "wallet": "8e9c53a62755bcc66e4d2aaae3a2af6d",
  "type": "saving",
  "transfer_key": "7j0ap91o99cxj8k97j0ap91o99cxj8k9",
  "currency": "btc",
  "callback":
  {
     "url": "http://example.com/callback",
     "data":
     {
        "invoice_id": "1234",
        "secret": "7j0ap91o99cxj8k9",
     }
  },
  "destinations":[
	{"address": "1apiKcJM95jENZeom2dQo8ShK7dUQkRaS", "amount": 40330},
	{"address": "1ApiwpetcWnBbkpU7cb7biPfc6Tiucasf8", "amount": 40330}
  ]
}

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

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

Обратный вызов URL КлючЗначение

+

АдресСумма

+


{
   "type": "forwarding",
   "callback":{
      "url" :  "http://example.com/callback"
   }
}
  
<?php
  $json_data = array (
    'type' => "forwarding",
    'callback' => array(
        'url'=> "http://example.com/callback"
    )
  );
  
  $api_endpoint = "https://apirone.com/api/v2/btc/wallet";
 
  $curl = curl_init($api_endpoint);
  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);
  $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 "Wallet: " . $decoded["wallet"] . "<BR>";
	  echo "Key: " . $decoded["transfer_key"];
  } else {
      var_dump($response);
  }
?>
Сделать запрос
Результат выполнения: