Введение

Интерфейс корзины (Shopping Cart Interface (SCI)) –) – это часть системы обменного пункта btc-exchange.biz, которая позволяет переводить платежи с банковой карты Покупателя на счет Продавца. Она используется для обработки платежей за продукты или услуги, предлагаемые Продавцом. В SCI и на веб-сайте Продавца используются простые формы в формате HTML для передачи необходимой информации между SCI и веб-сайтом Продавца, что позволяет Покупателю выполнять перевод платежа, а Продавцу – получать и надлежащим образом обрабатывать полученный платеж. С помощью SCI который равнозначен API интерфейсу, возможно :

– Создавать заявки на обмен с вашими реквизитами

– Просмотривать информацию о заявках, а тоесть их статус выполнения

– Видеть информацию по реквизитам заявки

– Получать информацию по успешной или не успешной заявке в считаные секунды

Подготовительные этапы

Вам нужно создать запись о магазине в SCI в Вашем аккаунте btc-exchange.biz. Для выполнения этой операции Вам нужно войти в Ваш аккаунт btc-exchange.biz и нажать на кнопку «Создать новый SCI» в разделе «Профиль -> API и SCI для разработчиков». Нажмите на кнопку «Создать» для создания нового SCI. Ваш SCI будет функционировать надлежащим образом, только при условии выполнения следующих шагов.

Настройте Ваш веб-сайт для надлежащего взаимодействия с btc-exchange.biz SCI. Вам потребуется указать следующую информацию:

  1. SCI name. Это название Вашего магазина, которое SCI будет использоваться при передаче формы запроса платежа.
  2. SCI password. Этот параметр используется системой аутентификации, когда SCI передает данные на веб-сайт Продавца.>
  3. Success URL. Это URL-адрес, на который SCI направляет Покупателя после успешного выполнения платежа. Как правило, на этой странице Покупатель получает уведомление о том, что платеж был успешно обработан. Вы можете опустить этот параметр и/или указать его в форме запроса платежа.
  4. Success URL HTTP method. В качестве метода перевода на страницу успешного выполнения платежа Продавца, Продавец может использовать следующие методы:
    • POST — форма успешного выполнения платежа направляется на страницу успешного выполнения платежа Продавца через запрос HTTPPOST;
    • GET — форма успешного выполнения платежа направляется на страницу успешного выполнения платежа Продавца через запрос HTTPGET;
    • LINK — SCI выполняет простое перенаправление на страницу успешного выполнения платежа Продавца через запрос HTTP LINK без передачи данных формы успешного выполнения платежа.
  5. Fail URL. Это URL-адрес веб-страницы, на которую SCI направляет Покупателя, если Покупатель отменяет платеж, или если платеж не был выполнен.
  6. Fail URL HTTP method. В качестве метода перевода на страницу невыполнения платежа Продавца, Продавец может использовать следующие методы:
    • POST — форма невыполнения платежа направляется на страницу невыполнения платежа Продавца через запрос HTTPPOST;
    • GET — форма невыполнения платежа направляется на страницу невыполнения платежа Продавца через запрос HTTPGET;
    • LINK — SCI выполняет простое перенаправление на страницу невыполнения платежа Продавца через запрос HTTP LINK без передачи данных формы невыполнения платежа.
  7. Status URL. Это адрес веб-страницы на сервере Продавца, на который SCI отправляет форму статуса платежа. Эта форма передается в фоновом режиме, когда Покупатель находится на веб-сайте SCI. URL-адрес может содержать параметры строки запроса (не обязательно), например: “http://www.merchant.com/status.php?a=123”.
  8. Status URL HTTP method. В качестве метода передачи данных, Продавец может использовать следующие методы:
    • POST — данные формы статуса платежа передаются через запрос HTTPPOST;
    • GET — данные формы статуса платежа передаются через запрос HTTPGET.

Процесс платежа

Основные принципы взаимодействия между веб-сайтом Продавца и веб-сайтом SCI включают в себя следующие этапы:

  1. Перенаправление Покупателя с веб-сайта Продавца на веб-страницу SCI и передача формы запроса платежа
  2. Получение данных формы успешного выполнения платежа и анализ данных.
  3. Получение данных формы невыполнения платежа и анализ данных.
  4. Получение и обработка формы подтверждения платежа.

Вам нужно направить Покупателя на вебсайт btc-exchange.biz SCI (и отправить форму запроса платежа) по следующему URL-адресу: https://wallet.btc-exchange.biz/sci/ .

Payment RequestForm(Форма запроса платежа) – это форма в формате HTML для запроса платежа, которая генерируется веб-сайтом Продавца и используется для передачи данных btc-exchange.biz SCI. Эта форма представляет собой набор скрытых полей, содержащих информацию, необходимую для завершения перевода черезSCI.

В таблице ниже указанные все приемлемые поля для формы HTML для надлежащего взаимодействия с SCI.

Название поля формы Обязательно Формат Описание Примеры значений
ac_account_ email Да Текстовая строка Номер счета продавца. account_email
ac_sci_name Да Текстовое поле, длина до 50 символов Название магазина Продавца. My Store
ac_amount Да Дробное число, содержащее до 2 цифр знаменателей Сумма для перевода на счет Продавца. 123.45
0.12
ac_currency Да RUB Валюта, в которой Покупатель должен оплатить заказ. RUB
ac_order_id Нет Текстовая строка, длина до 64 символов, “A- z”, “-“, “_”, “0-9” В этом поле Продавец настраивает идентифицирующий номер покупки, в соответствии с системой ведения учета. Рекомендуется, чтобы пользователи выбирали уникальный номер для каждого платежа. 123456, baf419d9-
6c82-4175-b870-
5541b0ff3794
ac_sign Да Шестнадцатиричный формат Контрольная подпись, которая используется для проверки подлинности полученной информации и однозначной идентификации отправителя. fbcb3778885695e50ac 5de774ad06b2de1f2bb a4833a79c21cfaf75bf fd2294d
ac_bayer_wa llet Нет В формате 1234 5678 9012 3456, длина 16 символов Кошелек Покупателя. Это поле является необязательным, но если оно существует, Покупатель не сможет выполнить платеж из любого другого кошелька. 1234 5678 9012 3456
ac_comments Нет Текстовая строка, длина до 255 символов Комментарии, которые Продавец может включить с платежом. Это поле является необязательным. Если это поле указано, Покупатель не может редактировать информацию в этом поле. Платеж за припейд карту WOT. Номинал 10$
ac_success_ url Нет Текстовая строка, длина до 100 символов URL-адрес страницы успешного выполнения платежа на веб-сайте Продавца. Это поле является необязательным. http://www.merchant
.com/success.html
ac_success_ url_method Нет • GET
• POST
• LINK
HTTP-метод перенаправления на страницу успешного выполнения платежа. Это поле является необязательным. GET
ac_fail_url Нет Текстовая строка, длина до 100 символов URL-адрес страницы невыполнения платежа на веб-сайте Продавца. Это поле является необязательным. http://www.merchant.com/fail.html
ac_fail_url_method Нет • GET
• POST
• LINK
HTTP-метод перенаправления на страницу POST
ac_status_url Нет Текстовая строка, длина до 100 символов URL-адрес страницы статуса платежа на веб-сайте Продавца. Это поле является необязательным. http://www.merchant.com/status.html
ac_status_url_method Нет • GET
• POST
HTTP-метод перенаправления на страницу статуса платежа. POST