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

Параметры платежной формы

После создания платежной формы и генерирования кода кнопки для установки на свой сайт, платежная форма становится доступна по URL, указанному в коде кнопки. API позволяет модифицировать платежную форму, передавая дополнительные GET параметры в URL платежной формы. Вы можете определять любые параметры. Предопределенные параметры прочитаются системой, остальные будут собраны и проброшены в обратный POST-запрос с сообщением о результате проведения транзакции.

Предопределенные параметры:

  • name - Заголовок для формы
  • description - Краткое описание услуги
  • curr - Фиатная валюта, rub(по-умолчанию), usd, eur
  • total - Сумма в валюте, указанной в currency
  • sign - Цифровая подпись данных, sha1-хэш строки, состоящей из конкаретации всех параметров запроса и ShopSecretKey

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

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

  • shopId - id магазина
  • valuta - btc, bch или ltc
  • summ - сумма
  • orderId - id заказа, если было указано
  • queryParams - строка json c параметрами из платежной формы
  • sign - md5(privateKey.shopId.valuta.summ.orderId.queryParams)

Если транзакция не подтверждается в течение срока отслеживания, то система отсылает такой-же POST запрос, только по URL для отмены оплаты

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

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