Формат запросов

Запросы осуществляются посредством протокола HTTP 2 или HTTP 1.1 с использованием SSL (HTTPS), на адрес:

https://api.cryptonator.com/api/merchant/v1/<имя метода>

Для передачи параметров запроса используется следующий формат:

  • каждый параметр указывается парой ключ/значение в виде параметра POST-запроса;
  • MIME-тип: application/x-www-form-urlencoded;
  • кодировка символов: UTF-8.

Требования безопасности:

  • Все сетевые взаимодействия производятся только по HTTPS.
  • Приложение должно проверять корректность SSL-сертификата сервера. Если SSL-сертификат не прошел проверку, необходимо немедленно прекратить сессию, чтобы не допустить утечку данных авторизации.

Подпись запросов

Каждый запрос (кроме /startpayment) должен быть подписан корректным ключом secret_hash.

secret_hash содержит значение хэш-функции SHA-1 от свертки ВСЕХ параметров запроса совместно с секретным словом, которое вы найдете в разделе МАГАЗИН, закладка Расширенные настройки. Параметры обязательно должны быть в том же порядке в котором они представлены на сайте.

secret_hash = sha1(string&secret)

Чтобы подписать свой запрос, рассчитайте хэш по алгоритму, приведенному ниже.

Пример формата строки для подписи запроса метода /getinvoice

merchant_id&invoice_id&secret

Пример строки

0dd0cf6fd32308b34c6e8b9cb578251f&baf37c414289a5a07095990e536ca958&334cf656287417fe0c85e4

Пример формата строки для подписи запроса метода /createinvoice

merchant_id&item_name&invoice_currency&invoice_amount&checkout_currency&language&secret

Пример строки

0dd0cf6fd32308b34c6e8b9cb578251f&Футболка&rur&1500&bitcoin&ru&1457641674&334cf656287417fe0c85e4