На данном веб-сайте используются файлы cookie. Продолжая просматривать наш веб-сайт, вы соглашаетесь с использованием файлов cookie. Подробнее об использовании файлов cookie.
Документация
Полная информация для оперативного решения ваших вопросов
- Запуск таксопарка
- Основные настройки
- Панель управления
- Заказы
- Клиенты
- Исполнители
- Магазин
- Отчеты
- Справочники
- Настройки
- Данные организации
- Тариф и оплата
- Заказы
- Рейсы
- Исполнители
- Дополнительные опции
- Классы авто
- СМС
- Погода
- Уведомление клиентам
- Шаблоны уведомлений
- Статусы заказов для клиентов
- Банковские карты
- Онлайн-касса
- Сервис вывода средств
- Карты и маршруты
- Внешние АТС
- Пользовательские поля
- Горячие клавиши
- Приложение для клиентов
- Функционал модулей
- Приложение исполнителя
- Приложение клиента
- Эквайринг и вывод средств
- Карты и навигация
- Интеграция по API
- Ответы на частые вопросы
API для пополнения балансов исполнителей
Базовый URL - https://da2.gootax.pro:80881) Пополнение баланса водителей через терминалы
Запрос от терминала в API Gootax.
POST {URL}/v3/terminal/refill
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
domain |
string |
+ |
Название домена |
worker_login |
integer |
+ |
Позывной исполнителя |
worker_password |
string |
- |
Пароль исполнителя |
sum |
double |
+ |
сумма (>=1) |
currency_code |
string |
+ |
Код валюты (RUB) |
comment |
string |
- |
Комментарий |
external_id |
string | - | Внешний ключ операции пополнения баланса |
Если мы получаем external_id, то проверяем его уникальность по всем записям за последние 2 часа. Если такая операция за последние 2 часа была, то выдадим ошибку и и пополнение не произойдет.
Пример ответа:
{
"code": 0,
"message": "OK",
transactionHash":"038f6ada6dc0f115b3cd66dd39fe784a",
external_id":"2343423с34с24с34с"
}
Пример ответа с ошибкой:
Не правильный логин | Дублирующийся external_id |
---|---|
{ |
{ |
2) Проверка существования исполнителя
Запрос от терминала в API Gootax.
POST {URL}/v3/terminal/check-worker
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
domain | string | + | Название домена |
worker_login | integer | + | Позывной исполнителя |
last_name | string | - | Фамилия исполнителя |
name | string | - | Имя исполнителя |
second_name | string | - | Отчество исполнителя |
Пример ответа:
{
"code": 0,
"message": "OK",
"name": "Евгений"
}
Пример ответа с ошибкой:
{
"name": "Unprocessable entity",
"message": "Bad params: worker_login: Worker Login is invalid./ ",
"code": 4,
"status": 422,
"type": "yii\\web\\HttpException"
}
3) Проверка успешности платежа
Запрос от терминала в API Gootax
POST {URL}/v3/terminal/check-success
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
uniq_hash | string | + | Уникальный хэш для каждой транзакции |
worker_login | integer | + | Позывной исполнителя |
worker_password | string | + | Пароль исполнителя |
domain | string | + | Название домена |
Пример ответа:
{
"code": 0,
"message": "OK"
}
Пример ответа с ошибкой:
{
"code": 142,
"message": "TRANSACTION_NOT_SUCCESS"
}