Документация: Руководство по подключению мерчанта оплаты

На этой странице описан принцип работы и подключения мерчанта для оплаты.

Если у Вас возникнут какие либо вопросы по подключению мерчанта или его работе Вы всегда можете обратится за консультацией к оператору

Перед подключением

Перед тем как обратится к оператору для подключения к нашему мерчанту рекомендуем подготовить такую информацию:

Название Вашего магазина (будет показано клиенту на странице оплаты)
Предпочитаемая валюта выплаты (не разглашается клиентам)
URL возврата клиента на Ваш сайт после оплаты (return_url)
URL получения сообщений о статусе платежа (status_url)

Эта информация понадобится оператору для успешного подключения Вас к системе.

Принцип работы мерчанта

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

https://24xbtc.com/api/sci

(метод POST) вместе с этим блоком данных. Далее пользователю будет показан интерфейс проведения оплаты, после обработки которого Ваш пользователь будет перенаправлен назад, на Ваш сайт, по адресу, который будет указан Вами как return_url. После проведения пользовательского платежа через нашу систему Вам, на адрес, который Вы укажете как status_url будет направлен запрос (методом POST) с данными о проведении платежа. Детальнее эти шаги мы сейчас рассмотрим ниже.

Сбор необходимой информации

Для того, что бы успешно сформировать посылку для отправки мерчанту Вам необходимо подготовить следующую информацию:

Сумма платежа* (в выбраной валюте) (число)
Валюта платежа* (должна совпадать с выбраной Вами валютой во время регистрации) (код валюты)
ID платежа в вашей учетной системе (строка)
Описание платежа (строка)
Ваш публичный ключ (строка(

*Указывайте ту валюту и сумму, которую хотите получить в итоге. Вашему клиенту будет предложено выбрать удобную для него валюту оплаты и соответствующую сумму в выбраной им валюте. Все вышеуказаные поля обязательны к передаче и должны быть не пустыми. Пример такой формы Вы можете найти в разделе Пример формы магазина

Формирование посылки и подписи

После того, как Вы получили все вышеуказанные данные Вам нужно объединить их в одну строку (сконкатенировать) используя как разделитель символ "+" Пример:

250+USD+Test_order+This is a test SCI order+xxPijn1bovXCZi8l

После получения этой строки Вам нужно закодировать ее с помощю алгоритма base64. В результате вы получите такую строку:

MjUwK1VTRCtUZXN0X29yZGVyK1RoaXMgaXMgYSB0ZXN0IFNDSSBvcmRlcit4eFBpam4xYm92WENaaThs

Эту строку нужно передать в запросе на мерчант в POST параметре data.
После получения data Вам необходимо вычислить HMAC хеш от нее использовав в качестве ключа ваш private_key и закодировать полученую строку в base64. Полученый результат необходимо передать мерчанту в POST параметре sign. В конечном итоге форма, по которой Вы должны будете перенаправить клиента будет выглядить так:

<form action="https://24xbtc.com/api/sci" method="post">
    <input type="hidden" name="data" value="MjUwK1VTRCtUZXN0X29yZGVyK1RoaXMgaXMgYSB0ZXN0IFNDSSBvcmRlcit4eFBpam4xYm92WENaaThs">
    <input type="hidden" name="sign" value="NTg4MzQwNWViZTE3YzRiZTU3MmRiYTA3ODM1MjJjMjI4MjcwODhmMw==">
    <button type="submit">Продолжить</button>
</form>

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

Обработка ответа от мерчанта

После того, как клиент проведет оплату завяки мерчант отправит на адрес, указаный Вами при регистрации как status_url POST запрос с полями sign и data. Параметр data вам нужно будет декодировать в формате base64. Полученая строка будет предствлять собой следующее параметры объединенные символом "+":

Статус платежа (число)
Идентификатор заявки в нашей системе (число)
ID платежа в вашей учетной системе (строка)
Сумма платежа (число)
Статус обработки завяки нашей системой (число)

Поле "Статус платежа" может принимать значения 0 (платеж неуспешен, завяка в нашей системе не создана) или 1 (платеж успешен, заявка успешно поставлена в обработку). Поле "Статус обработки завяки нашей системой" может принимать значения 0 (заявка создана), 1 (завяка оплачена клиентом), 2 (завяка выплачена в Вашу пользу) или 3 (завяка отменена). Поле sign содержит в себе HMAC хеш поля data с вашим private_key в качестве ключа. После получения этого сообщения в любой момент Вы можете сделать запрос по адресу

https://24xbtc.com/api/sci-status

методом POST, передав параметры public_key (ваш публичный ключ) и bid_id (идентификатор заявки в нашей системе) и получить актуальный статус обработки платежа. Рекомендуем переодически повторять такой запрос пока Вы не получите подтверждения полной обработки завяки с нашей стороны. Формат ответа на такой запрос такой же, как описан выше.