API для разработчика

Для создания заказа необходимо отправить POST или GET запрос на адрес: https://bitx.land/payment/api содержимое запроса:

  • shopId - id магазина - обязательное поле
  • valuta - btc, bch или ltc - обязательное поле
  • summ - сумма - обязательное поле
  • orderId - id заказа, необязательное поле
  • goodName - название товара, закодированный в urlencode, необязательно
  • goodOpis - описание товара, закодированный в urlencode, необязательно
  • key - md5(privateKey.shopId.valuta.summ.orderId)

В ответ придет json:

  • success - результат, true - все ок, false - ошибка
  • url - ссылка для оплаты
  • id - id заказа

Пример кода на PHP

$url = 'https://bitx.land/payment/api';
$url .= '?shopId='.$shopId;
$url .= '&valuta='.$valuta;
$url .= '&summ='.$summ;
$url .= '&orderId='.$orderId;
$url .= '&goodName='.urlencode($goodName);
$url .= '&goodOpis='.urlencode($goodOpis);
$url .= '&key='.md5($shopSecret . $shopId . $valuta . $summ . $orderId);
$res = file_get_contents($url);

Доступны валюты: биткоин, биткоинкеш, лайткоин. На этом шаге создается новый кошелек, и все данные сохраняются в БД. У подобных кошельков будет срок годности, а точнее срок годности отслеживания их пополнения.

Как только система увидела, что поступили средства на кошелек, она отправляет POST запрос по указанному в URL для успешной оплаты адресу:

  • shopId - id магазина
  • valuta - btc, bch или ltc
  • summ - сумма
  • orderId - id заказа, если было указано
  • key - md5(privateKey.shopId.valuta.summ.orderId)

Чтобы избежать фальсификации запроса - необходимо проверить key - он должен быть равен md5(privateKey.shopId.valuta.summ.orderId) - где точка - снак соединения двух строк.

Как только система увидела, что оплата была произведена - счет закрывается, и поступления на этот адрес более не отслеживаются.

https://bitx.land/payment/listInvoice - список созданных по апи оплат входящие параметры:

  • shopId - id магазина - обязательное поле
  • key - md5(privateKey.shopId)

В ответ получаем json со списком id

  • success - результат,
  • true - все ок,
  • false - ошибка,
  • data - массив

Пример кода на PHP

$url = 'https://bitx.land/payment/listInvoice';
$url .= '?shopId='.$shopId;
$url .= '&key='.md5($shopSecret . $shopId);
$res = file_get_contents($url);

https://bitx.land/payment/getInvoice - информация по созданной оплате входящие параметры:

  • shopId - id магазина - обязательное поле
  • payId - id оплаты
  • key - md5(privateKey.shopId.payId)

В ответ получаем json со всеми данными

  • success - результат,
  • true - все ок,
  • false - ошибка,
  • data - массив

Пример кода на PHP

$url = 'https://bitx.land/payment/getInvoice';
$url .= '?shopId='.$shopId;
$url .= '&payId='.$payId;
$url .= '&key='.md5($shopSecret . $shopId .$payId);
$res = file_get_contents($url);