Документация

Полная информация для оперативного решения ваших вопросов

API для пополнения балансов исполнителей

Базовый URL - https://da2.gootax.pro:8088

1) Пополнение баланса водителей через терминалы

Запрос от терминала в 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

{
"name": "Unprocessable entity",
"message": "Bad params: worker_login: Worker Login is invalid./ ",
"code": 4,
"status": 422,
"type": "yii\\web\\HttpException"
}

{
"name": "Unprocessable entity",
"message": "Double external_id",
"code": 4,
"status": 422,
"type": "yii\\web\\HttpException"
}

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"
}

Заказать звонок

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробуйте бесплатно

Заполните ваши контактные данные, и мы свяжемся с вами в ближайшее время

Нажимая кнопку Отправить, я принимаю политику конфиденциальности

Успешно

Данные отправлены.
Мы свяжемся с вами в ближайшее время.

Закрыть

Попробовать

Оставить заявку