Создать кошелек

Это базовое API для работы с процессингом. После создания кошелька вы можете использовать все возможности сервиса. Кошельки могут быть накопительные (сейвинг) и с мгновенным перенаправлением (форвардинг).

Bitcoin QR code icon

Contents

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

Накопительный кошелек содержит множество адресов. Используя API кошелька, вы можете создавать новые криптовалютные адреса для приема платежей и делать выплаты одному или нескольким получателям.

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

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

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

Запрос:

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

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

{currency} Тип валюты: "btc", "ltc" Обязательное поле
Ссылка на страницу колбека (Опциональное поле)

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

{callback:url}
string,
=< 1024 chars

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

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

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

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

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

Пример запроса (сейвинг):
{
  "currency": "btc",               #required
  "callback":{                     #optional
      "url": "your_callback_URL",  #optional
      "data":{                     #optional
         "optional_key": "value"
      }
   }
}
Биткоин-адрес получателя и сумма

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

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

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

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

1apiKcJM95jENZeom2dQo8ShK7dUQkRaS

bc1qggg2ys8duv4qvnfgzng2p75m6ehklcmfygr9m4

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

Сумма

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

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

253999

"20%"

"31.55%"

Пример запроса (форвардинг):
{
    "currency": "btc",               #required
    "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
Идентификатор кошелька. Кошелек содержит множество биткоин-адресов. Обязательное поле
{created}
string
Дата создания кошелька. Содержит полную дату, часы, минуты, секунды, десятичную часть секунды: гггг-мм-ддTчч:мм:сс.с Обязательное поле
{currency}
string
Тип криптовалюты: btc, ltc. Обязательное поле
{transfer_key}
string
Ключ для перевода средств (выплаты). Обязательное поле
{destinations}
array of objects
Биткоин-адрес Интернет-магазина, куда будет произведен форвардинг платежа. Обязательное поле
{callback}
array
Колбек - это массив из URL и данных пользователя. Опциональное поле
{fee}
string
Стратегия выбора комиссии сети. Может принимать значения "normal", "priority" (Комиссия сети) или "custom". С пользовательской стратегией можно задать комиссию сети, используя поле {fee-rate}. Опциональное поле
Пример результата выполнения:
{
  "wallet": "btc-8e9c53a62755bcc66e4d2aaae3a2af6d",
  "created": "2020-12-20T12:20:20.193984",
  "currency": "btc",
  "transfer_key": "7j0ap91o99cxj8k97j0ap91o99cxj8k9",
  "destinations":
  [
      {"address": "1apiKcJM95jENZeom2dQo8ShK7dUQkRaS", "amount": 40330},
      {"address": "1ApiwpetcWnBbkpU7cb7biPfc6Tiucasf8", "amount": 40330}
  ],
  "callback":
  {   
     "method": "POST",
     "url": "http://example.com/callback",
     "data":
     {
        "invoice_id": "1234",
        "secret": "7j0ap91o99cxj8k9",
     }
  },
  "fee": "normal"
}

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

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

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

+

{
 "currency": "btc",
 "callback":{
    "url" :  "http://example.com/callback"
 }
}

<?php
$json_data = array (
  'currency' => "btc",
  'callback' => array(
      'url'=> "http://example.com/callback"
  )
);

$api_endpoint = "https://apirone.com/api/v2/wallets";

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