Globus
интерфейс программного взаимодействия с магазинами (версия 1.3)
Оглавление
Общая информация 1
Отправка запроса на Сервер 2
Ответы от Сервера 3
Продажа, завершение продажи, отмена продажи 3
Запрос данных о покупке 4
Запрос остатка на счету 5
Запрос истории операций 6
Коды ответов от сервера 7
Общая информация
API предназначен для автоматизации взаимодействия партнерских магазинов и серверов Globus при уведомлении о продажах партнерскими магазинами товаров и услуг пользователям сайта Globus.
Адрес шлюза взаимодействия: https://globus-inter.com/api/shop-gate.php
Протокол передачи данных: HTTPS (рекомендуется), HTTP
Метод передачи данных: POST
Пример кода на PHP: https://globus-inter.com/download/doc/globus_api.zip
Отправка запроса на Сервер
# |
Имя |
Тип |
Действие |
Примечание |
||||||
Продажа |
Завершение продажи |
Отмена продажи |
Запрос данных о продаже |
Запрос остатка на счету |
Запрос истории операций |
|||||
1 |
api_ver |
float |
+ |
+ |
+ |
+ |
+ |
+ |
Версия API: дробная часть отделяется точкой (1.0, 1.1, 2.5) |
|
2 |
task |
integer |
+ |
+ |
+ |
+ |
+ |
+ |
Действие: 0 - продажа, 1 - завершение продажи, 2 - отмена продажи, 3 - запрос данных о продаже, 4 – запрос баланса, 5 – запрос истории операций |
|
3 |
shop_id |
integer |
+ |
+ |
+ |
+ |
+ |
+ |
ID магазина: присваивается магазину при регистрации. По внутренней системе учета Сервера. (1, 234) |
|
4 |
user_id |
integer |
+ |
|
|
|
|
|
ID пользователя Глобус: его сообщает пользователь при покупке или передается в GET-параметрах сайту магазина при переходе |
|
5 |
pay_id |
integer |
+ |
+ |
+ |
+ |
|
|
ID покупки: По внутренней системе учета магазина (1, 123, 45678). |
|
6 |
pay_way |
string |
+ |
|
|
|
|
|
Способ оплаты: произвольная строка (VISA, Webmoney, наличными). |
|
7 |
pay_for |
string |
+ |
|
|
|
|
|
Товар или услуга: произвольная строка названия (Transcend Flash drive 32GB). |
|
8 |
pay_amount |
float |
+ |
|
|
|
|
|
Сумма платежа: дробная часть отделяется точкой (100.5, 23.15) |
|
9 |
com_percent |
float |
+ |
|
|
|
|
|
Комиссионные (%): 100% = 1. Дробная часть отделяется точкой (0.05, 0.03) |
|
10 |
com_amount |
float |
+ |
|
|
|
|
|
Комиссионные (сумма): Дробная часть отделяется точкой (100.5, 23.15) |
|
11 |
pay_time |
string |
+ |
|
|
|
|
|
Время покупки: Строка в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС (2015-06-15 14:25:53) |
|
12 |
is_finished |
integer |
+ |
+ |
|
|
|
|
Флаг завершенности продажи: 0 - продажа не завершена, 1 - продажа завершена. |
|
13 |
is_debug |
integer |
+ |
+ |
+ |
+ |
|
|
Флаг режима отладки: 0 - реальная продажа, 1 - режим отладки. |
|
14 |
date_from |
string |
|
|
|
|
|
+ |
Начальная дата выборки. Строка в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС |
|
15 |
date_to |
string |
|
|
|
|
|
+ |
Конечная дата выборки. Строка в формате ГГГГ-ММ-ДД ЧЧ:ММ:СС |
|
16 |
note |
string |
|
|
|
|
|
|
Примечание. |
|
17 |
sign |
string |
|
|
|
|
|
|
Хеш данных. Формируется магазином для контроля целостности данных платежа при получении информации от Сервера. |
|
18 |
x_shop_addr |
string |
|
|
|
|
|
|
Дополнительное поле магазина. |
|
Примечание:
Рекомендуется использовать самую последнюю версию API взятую с нашего сайта.
Параметры начинающиеся с "x_" - это нестандартизированные параметры добавляемые магазином. Они будут возвращены в неизменном виде при ответе сервера.
При информировании о продаже (task=0), флаг завершенности (is_finished) может быть установлен (1) сразу, если возврат товара либо услуги не возможен. В таком случае уже будет не нужно информировать Сервер о завершении продажи (task=1).
При формировании подписи (поле sign) следует учитывать, что все строковые параметры обрезаются до длины в 100 символов и к ним применяется php-функция trim(). Поля pay_amount и com_amount сохраняются с точностью до 2-х знаков после точки, поле com_percent – до 4-х знаков после точки.