На данном веб-сайте используются файлы 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"
}