Метод: pay
Метод служит для осуществления перевода средств на мобильный телефон.
URL
POST https://api.prostodar.ru/partner/mobile/pay/
Описание
Метод позволяет выполнить перевод средств на мобильный телефон. Для выполнения запроса необходимо указать данные абонента и авторизационные данные партнера.
Структура запроса
Пример запроса
Формат запроса:
POST https://api.prostodar.ru/partner/mobile/pay/ ?partnerName=name &partnerPassword=password &requestId=some_request_id &phoneNumber=1234567890 &sum=100 &operatorCode=12345 &idPerson=idPerson &useAuthByCert=Y
Параметры запроса
Параметр | Тип | Описание | Обязательный | Шифрование | |
---|---|---|---|---|---|
partnerName |
string | Уникальное имя партнера | Да | Нет | |
partnerPassword |
string | Уникальный API пароль партнера | Да | Да | |
requestId |
string | Уникальный идентификатор запроса | Да | Да | |
phoneNumber |
string | Номер телефона в формате 10 цифр | Да | Да | |
sum |
float | Сумма перевода в рублях | Да | Да | |
operatorCode |
int | Код оператора | Нет | Да | |
idPerson |
string | Уникальный идентификатор лица, в адрес которого осуществлен выпуск вознаграждения | Да, если используется совместно с сервисом верификации ПД | Да | |
useAuthByCert |
string | Указывает на использование шифрования данных | Да | Нет |
Структура ответа
Пример успешного ответа
{
"status": "OK",
"message": "request successfully completed",
"paymentId": "8654854"
}
Параметры успешного ответа
Параметр | Тип | Описание |
---|---|---|
status |
string | Статус прохождения запроса |
message |
string | Текстовое описание результата выполнения запроса |
paymentId |
string | Внешний идентификатор транзакции |
Пример ответа с ошибкой
{
"status": "PARTNER_LOGIN_IS_NOT_CORRECT",
"message": "Partner name or password is not correct"
}
Параметры ответа с ошибкой
Параметр | Тип | Описание |
---|---|---|
status |
string | Статус ошибки |
message |
string | Текстовое описание ошибки |
Возможные ошибки
Статус | Текстовое описание ошибки | Описание |
---|---|---|
PARTNER_LOGIN_IS_NOT_CORRECT |
Partner name or password is not correct | Партнер с таким логином и паролем не найден |
NOT_VALID_IP_PARTNER |
Partner IP is not correct | IP партнера некорректен |
ACCOUNT_IS_BLOCKED |
Account is blocked | Аккаунт заблокирован |
REQUEST_INCORRECTLY |
Invalid authorization is used | Ошибка в шифровании сертификатом |
REQUEST_ID_ALREADY_EXISTS |
Request id already exists | Запрос с таким идентификатором уже существует |
NO_MONEY |
There are no funds on the balance sheet | Недостаточно средств для операции |
SERVICE_UNAVAILABLE |
Service is temporarily unavailable. | Сервис временно недоступен |
SUBSCRIBER_NOT_FOUND |
Subscriber not found | Абонент не найден |
MOBILE_NOT_RESPONDING |
The operator is not respondin | Ошибка оператора |
AMOUNT_IS_NOT_IN_RANGE |
- | Сумма операции меньше минимального порога |
FIELD_IDPERSON_IS_NOT_CORRECT |
The field idPerson must be filled in | Поле idPerson должно быть заполнено. Актуально, когда данный сервис используется совместно с сервисом верификации ПД. |
REQUEST_ID_IS_TOO_LONG |
Request id is too long. Maximum 30 characters | Длина requestId не может превышать 30 символов. |
MOBILE_ERROR |
- | Ошибка оператора |
GENERIC_ERROR |
Generic error | Внутренняя ошибка оператора |
INVALID_REQUEST_FORMAT |
Invalid request format | Неверный формат запроса |
Unknown error. Please again try later |
- | Данный тип вознаграждения или оператор связи временно недоступен |