Too AsiaPay Almaty KAZ списали деньги без моего ведома: что делать?
Порой, люди получают смс, в которых сказано о списаниях в пользу неизвестных им получателей. Например, в последнее время в сети стали часто появляться жалобы на то, что со счетов исчезают денежные средства. При этом получателем является Too AsiaPay Almaty KAZ.
Что это такое
Из приписки «Almaty KAZ» становится ясно, что компания, снявшая средства, территориально расположена в Алматы (Казахстан). Для проверки компании, можно обратиться к сети и обнаружить, что в Казахстане, действительно, есть такая компания и работает она вполне легально. 
Too AsiaPay или ОО «ASIAPAY (АЗИЯПЭЙ)» является одним из ведущих платежных сервисов нового поколения в Казахстане. Компания владеет интегрированной платежной сетью, которая позволяет оплачивать покупки, услуги, предоставляемые Интернет-провайдером, мобильную связь и пр.
ОО «ASIAPAY (АЗИЯПЭЙ) предлагает следующее:
Таким образом, Too AsiaPay или ОО «ASIAPAY (АЗИЯПЭЙ)» – это не мошенническая компания, а легальный оператор проведения платежей. 
Таким образом, в данном случае данная организация не является конечным получателем средств. Это лишь посредник в оказании проведения транзакций.
Что же делать
Для начала, следует подумать, что же за операция могла быть проведена. Есть вероятность, что это всего лишь автоплатеж, подключенный самим клиентом. Например, человек не хочет каждый раз вбивать реквизиты Интернет-провайдера, либо боится забыть об очередном внесении платежей. В этом случае он ставит автооплату на конкретное число месяца и Too AsiaPay без его ведома проводит оплату.
Таким образом, все довольны, ведь компания получит свою комиссию, поставщику услуг будут вовремя перечислены деньги, а клиент будет пользоваться услугами без перебоя.
Однако, если все же выяснится, что никаких автоплатежей у человека нет и деньги списаны просто так, то лучше всего обратиться напрямую в Too AsiaPay. Сделать это можно, написав электронное письмо на e-mail – info@asiapay.kz.
Там нужно будет изложить суть своего обращения, а также приложить скрины банковской выписки. Также потребуется написать и заявление на возврат денежных средств. Ответ от компании должен быть дан в течение трех рабочих дней.
Введение
Введение
В рамках документации используются следующие сокращения и определения:
Обратная связь
Вопросы и предложения по документации можно направлять на электронный адрес support@asiapay.kz, а также по реквизитам указанным в разделе контакты на официальном сайте asiapay.kz
Этапы имплементации
Заключение партнерского договора
Регистрация партнера и получение доступов в личный кабинет
Общие сведения по подключению
Следование правильной последовательности API вызовов является важнейшим условием корректности работы интеграционного уровня!
result_url партнера будет вызываться методом HTTP/POST. В случае ошибки, будет передан так же код и описание ошибки. Примеры уведомлений указаны для каждого метода отдельно
Для проведения операций пополнения и списания, на балансе Партнера необходим положительный баланс, не менее суммы операций.
Подключение
Все запросы к API должны быть авторизованы, иначе в ответ будет получена ошибка 403. Авторизация проходит методом HTTP Basic, в заголовке запроса Authorization передается логин и пароль. Данные авторизации предоставляются отдельно от документа.
Данные для подключения:
| Наименования | Значение |
|---|---|
| Тестовый URL | https://apitest.asiapay.kz |
| Боевой URL | https://api.asiapay.kz |
| Порт | 443 |
| Авторизация | HTTP Basic |
| Формат запроса | application/json |
| Формат ответа | application/json |
| Кодировка | UTF-8 |
Оплата с баланса мобильного
В этом разделе описана механика, когда Asiapay.kz списывает деньги с баланса абонента, либо пополняет баланс абонента.
Мерчант может использовать этот раздел для прямого подключения со своим сервисом.
Пополнение баланса абонента
Платеж успешно создан (с подтверждением)
Платеж успешно создан (без подтверждения)
Метод позволяет пополнить баланс абонента.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | float | Сумма платежа |
| payment.commission_amount | float | Сумма комиссии |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю на запрошенном языке |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
Путь прохождения платежа
Списание с баланса абонента
Платеж успешно создан (без подтверждения)
Платеж успешно создан (с подтверждением)
Метод используется для списания с баланса абонента.
При списании может быть использован бонусный счет (интеграция с системой LoyaltyBox). В этом случае номер абонента должен быть привязан к UUID бонусного аккаунта в LoyaltyBox.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | float | Сумма платежа |
| payment.commission_amount | float | Сумма комиссии |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю на запрошенном языке |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
Путь прохождения платежа без бонусов
Путь прохождения платежа с бонусами
Инициализация платежа
При списании может быть использован бонусный счет (интеграция с системой LoyaltyBox). В этом случае номер абонента должен быть привязан к UUID бонусного аккаунта в LoyaltyBox.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | float | Сумма платежа |
| payment.commission_amount | float | Сумма комиссии |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
Путь прохождения инициализации
Подтверждение платежа
Подтверждение платежа
В случаем если платеж был создан через метод payment/init и не были запрошены данные для подтверждения, ключ confirm_inputs передавать не нужно.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| confirm_inputs | object | Нет | Объект содержит поля, которые требуется передать для подтверждения платежа. Должен содержать как минимум один ключ и значение. Передается только в том случае, если были запрошены поля подтверждения |
| otp | string | Нет | OTP код, если был запрошен |
| keyword | string | Нет | Кодовое слово, если было запрошено |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.receipt_url | string | Ссылка страницу просмотра и скачивания чека |
| payment.amount | float | Сумма платежа |
| payment.commission_amount | float | Сумма комиссии |
Отправка OTP кода
Метод используется для отправки OTP кода.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
Получение статуса
Метод позволяет получить текущий статус платежа.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
Возврат платежа после оплаты
Возврат платежа после оплаты
Метод может быть использован для возврата средств клиенту на баланс в том случае, если услуга уже была оказана. Некоторые операторы поддерживают частичный возврат.
В том случае если, пользователю был начислен кешбек по программе лояльности, он будет возвращен полностью, даже если возврат частичный.
В том случае, если при оплате были использованы бонусы, то возвращаются сначала бонусы, а потом деньги на баланс абонента.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| reason | string | Да | Причина отмены |
| amount | number | Нет | Сумма возврата в тенге. По умолчанию сумма заказа |
| result_url | string | Нет | URL для отправки сообщения о выполнении операции. Методом POST (пункт 4.12) |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID возвратного платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
Отмена платежа до оплаты
Отмена платежа до оплаты
Метод используется для отмены платежа, услуга по которому еще не была оказана.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| reason | string | Да | Причина отмены |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
Получение чека
Метод используется для получения полей для генерации чека на стороне мерчанта. Так же содержит ссылку на чек на сайте Asiapay.kz.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| language | string | Нет | Язык ответа. Возможные значения ru, kz, en |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| receipt.payment | object | Объект содержит поля для формирования чека |
| receipt.payment.service | string | Название услуги |
| receipt.payment.transactionDescription | string | Реквизит платежа |
| receipt.payment.operationId | integer | № операции |
| receipt.payment.checkNumber | integer | Номер чека |
| receipt.payment.abonent | string | Плательщик |
| receipt.payment.billAmount | string | Сумма |
| receipt.payment.commissionAmount | string | Комиссия |
| receipt.payment.totalAmount | string | Итого |
| receipt.payment.completedAt | string | Дата/Время завершения операции |
| receipt.payment.issuer | string | Эмитент |
| receipt.payment.issuer_bin | string | БИН Эмитента |
| receipt.payment.em_operator | string | Оператор ЭД |
| receipt.url | string | Ссылка страницу просмотра и скачивания чека |
Получение чека без авторизации
Получение чека без авторизации
Метод используется для получения полей для генерации чека на стороне мерчанта. Так же содержит ссылку на чек на сайте Asiapay.kz. Метод не требует авторизации.
Метод не требует авторизации
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| phone | integer | Да | Номер телефона абонента. 11 цифр |
| language | string | Нет | Язык ответа. Возможные значения ru, kz, en |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| receipt.payment | object | Объект содержит поля для формирования чека |
| receipt.payment.service | string | Название услуги |
| receipt.payment.transactionDescription | string | Реквизит платежа |
| receipt.payment.operationId | integer | № операции |
| receipt.payment.checkNumber | integer | Номер чека |
| receipt.payment.abonent | string | Плательщик |
| receipt.payment.billAmount | string | Сумма |
| receipt.payment.commissionAmount | string | Комиссия |
| receipt.payment.totalAmount | string | Итого |
| receipt.payment.completedAt | string | Дата/Время завершения операции |
| receipt.payment.issuer | string | Эмитент |
| receipt.payment.issuer_bin | string | БИН Эмитента |
| receipt.payment.em_operator | string | Оператор ЭД |
| receipt.url | string | Ссылка страницу просмотра и скачивания чека |
Запрос текущего баланса Партнера
Метод может быть использован для просмотра текущего баланса в системе МФС у текущего аккаунта. Тело запроса пустое.
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| balances | object | Объект содержит элементы, содержащие ID баланса и сумму остатка на момент запроса. |
Создание счета в программе лояльности
Создание счета в программе лояльности
При проведении платежей, может быть использован бонусный счет абонента в системе LoyaltyBox. Для этого каждый абонент должен иметь аккаунт в LoyaltyBox, а МФС должен хранить информацию о связи абонента и аккаунта в LoyaltyBox.
Метод loyalty/create позволяет создать новый аккаунт в LoyaltyBox и связать его с абонентом в МФС. В случае последующих платежей для текущего мерчанта будет использована эта связка.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | string/uuid | Нет | Идентификатор счета, UUIDv4 |
| name | string | Нет | Имя пользователя счета |
| phone | string | Да | Телефонный номер абонента |
| string | Нет | Email пользователя счета |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| id | string/uuid | Идентификатор созданного счета в LoyaltyBox |
Закрытие счета в программе лояльности
Закрытие счета в программе лояльности
Метод используется в том случае, если требуется закрыть бонусный счет абонента. При этом баланс бонусного счета будет переведен на другой счет, указанный в запросе.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | string/uuid | Да | Идентификатор счета, UUIDv4 |
| reference_id | string | Нет | ID операции в системе отправителя |
| description | string | Да | Описание к операции закрытия |
| corresponding_account_id | string/uuid | Да | ID счета, на который необходимо перевести остаток с закрывающегося счета, UUIDv4 |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| operation_id | number | ID операции перевода |
Привязать номер абонента к счету в программе лояльности
Привязать номер абонента к счету в программе лояльности
Метод используется в том случае, если мерчант создал ранее счет в системе LoyaltyBox и требуется только связать этот счет с номером абонента в МФС для дальнейших операций.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | string/uuid | Да | Идентификатор счета, UUIDv4 |
| phone | string | Да | Мобильный номер абонента |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
Оплата услуг
Витрины услуг позволяют оплачивать различные услуги с баланса абонента.
Получение каталога
Метод возвращает все доступные для отображения клиенту категории и сервисы.
Если в запросе передать дополнительный параметр name (например: «ставки» или «букмекер»), то только подходящие под этот параметр услуги будут переданы в ответе.
Поиск производится как по названию услуг, так и по алиасам (псевдонимам) услуг витрины для текущего мерчанта.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| language | string | Нет | Язык (en, kz, ru) |
| name | string | Нет | Строка для поиска по названию услуги или по алиасу для текущего мерчанта |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| catalogs | array | Массив с категориями каталога |
| catalogs.*.id | integer | ID категории в каталоге |
| catalogs.*.parent_id | integer | ID родительской категории в каталоге |
| catalogs.*.name | string | Название категории |
| services | array | Массив доступных сервисов |
| services.*.id | integer | ID сервиса |
| services.*.catalogs | array | Массив ID категорий, к которым относится сервис |
| services.*.name | string | Название сервиса |
| services.*.description | string | Описание сервиса |
| services.*.icon | string | Путь до изображения для отображения в каталоге |
Headers
Headers
Получение информации о сервисе
Получение информации о сервисе
Метод возвращает информацию о сервисе, включая комиссии, лимиты и поля, которые требуется заполнить.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| service_id | integer | Да | ID сервиса |
| language | string | Нет | Язык (en, kz, ru) |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| service | object | Объект, содержащий информацию о сервисе |
| service.id | integer | ID сервиса |
| service.catalogs | array | Массив категорий, к которым относится сервис |
| service.catalogs.*.id | integer | ID категории |
| service.catalogs.*.name | string | Название категории |
| service.name | string | Название сервиса |
| service.description | string | Описание сервиса |
| service.icon | string | Путь до изображения для отображения в каталоге |
| service.inputs | array | Массив объектов, содержащих данные о полях, которые требуется заполнить клиенту |
| service.inputs.*.field | string | Имя поля для отправки при проведении платежа |
| service.inputs.*.name | string | Название поля для отображения пользователю |
| service.inputs.*.label | string | Описание поля для отображения пользователю |
| service.inputs.*.type | string | Тип поля для заполнения (phone, email, digits или null) |
| service.inputs.*.mask | string | Применяемая маска для валидации (null, phone, money, otp или регулярное выражение) |
| service.limits | object | Объект, содержащий информацию о лимитах на одну операцию |
| service.limits.min | integer | Минимальная сумма |
| service.limits.max | integer | Максимальная сумма |
| service.commissions | array | Массив объектов, содержащих информацию о комиссиях в зависимости от мобильного оператора |
| service.commissions.*.operator | string | Код мобильного оператора (tele2, altel, kcell, activ, beeline) |
| service.commissions.*.fixed | integer | Фиксированная комиссия |
| service.commissions.*.percent | integer | Комиссия в процентах |
| service.commissions.*.min | integer | Минимальная комиссия |
Headers
Headers
Валидация данных платежа
Метод позволяет проверить валидность данных, которые ввел пользователь для оплаты услуг сервиса. Например номер телефона или логин в сервисе.
Рекомендуется вызывать этот метод всегда перед отправкой проведения платежа.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| service_id | integer | Да | ID сервиса |
| inputs | object | Да | Объект содержит все поля field, которые были перечислены в информации о сервисе |
| phone | string | Да | Номер телефона абонента |
| amount | integer | Да | Сумма платежа |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| commission | array | Информация о комиссии для текущего номера телефона по оператору |
| commission.operator | string | Код мобильного оператора (tele2, altel, kcell, activ, beeline) |
| commission.fixed | integer | Фиксированная комиссия |
| commission.percent | integer | Комиссия в процентах |
| commission.min | integer | Минимальная комиссия |
| errors | object | Информация об ошибках, в случае их возникновения |
| errors.* | array | Массив ошибок по указанному в ключе полю |
Headers
Headers
Проведение платежа
Проведение платежа может быть осуществлено как в один, так и в два этапа. Это зависит от настроек терминала для текущего мерчанта.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| service_id | integer | Да | ID сервиса |
| amount | integer | Да | Сумма платежа |
| phone | string | Да | Номер телефона абонента |
| inputs | object | Да | Объект содержит все поля field, которые были перечислены в информации о сервисе |
| use_bonuses | boolean | Нет | Если true, МФС попытается списать сумму с бонусного счета абонента, остаток будет списан с реального счета абонента. |
| channel | string | Нет | Канал поступления платежа. Может быть указан один из трех вариантов: online, terminal, app |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment | object | Объект содержит информацию о платеже |
| payment.id | integer | ID платежа в системе МФС |
| payment.amount | integer | Сумма |
| payment.commission_amount | float | Сумма комиссии, которая была применена к платежу |
| payment.status | string | Статус платежа из таблицы 3 |
| payment.receipt_url | string | Ссылка на страницу просмотра чека |
| confirm_inputs | array | Массив содержит список полей для подтверждения платежа клиентов |
| confirm_inputs.name | string | Название поля для отображения клиенту |
| confirm_inputs.value | string | Название поля для отправки методом подтверждения платежа |
Headers
Headers
Подтверждение платежа
Метод используется в том случае, если при вызове services/pay была запрошена подтверждающая информация.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| confirm_inputs | object | Нет | Объект содержит поля, которые требуется передать для подтверждения платежа. Должен содержать как минимум один ключ и значение. Передается только в том случае, если были запрошены поля подтверждения |
| otp | string | Да | OTP код, если был запрошен |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | float | Сумма платежа |
| payment.commission_amount | float | Сумма комиссии |
| payment.receipt_url | string | Ссылка страницу просмотра и скачивания чека |
Headers
Headers
Повторная отправка OTP
Повторная отправка OTP
Метод используется для повторной отправки OTP кода.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
Headers
Headers
Проверка статуса платежа
Проверка статуса платежа
Метод позволяет получить текущий статус платежа.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
Headers
Headers
Получение чека
Метод позволяет получить информацию о платеже для формирования чека.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| payment_id | integer | Да | ID транзакции. Пользователь получает ее в СМС после успешного завершения платежа. |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения операции из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| receipt.payment | object | Объект содержит информацию о платеже |
| receipt.payment.service | string | Название услуги |
| receipt.payment.transactionDescription | string | Реквизит платежа |
| receipt.payment.operationId | integer | № операции |
| receipt.payment.checkNumber | integer | Номер чека |
| receipt.payment.abonent | string | Плательщик |
| receipt.payment.billAmount | string | Сумма |
| receipt.payment.commissionAmount | string | Комиссия |
| receipt.payment.totalAmount | string | Итого |
| receipt.payment.completedAt | string | Дата/Время завершения операции |
| receipt.payment.issuer | string | Эмитент |
| receipt.payment.issuer_bin | string | БИН Эмитента |
| receipt.payment.em_operator | string | Оператор ЭД |
| receipt.payout | object | Объект содержит информацию о выплате |
| receipt.payout.sender | string | Отправитель |
| receipt.payout.recipient | string | Получатель |
| receipt.payout.operationId | integer | № операции |
| receipt.payout.abonent | string | Абонент |
| receipt.payout.billAmount | string | Сумма |
| receipt.payout.commissionAmount | string | Комиссия |
| receipt.payout.totalAmount | string | Итого |
| receipt.payout.completedAt | string | Дата/Время завершения операции |
| receipt.payout.service | string | Название услуги |
| receipt.payout.issuer | string | Эмитент |
| receipt.payout.issuer_bin | string | БИН Эмитента |
| receipt.payout.em_operator | string | Оператор ЭД |
| receipt.url | string | Ссылка на чек |
Headers
Headers
Переводы
С SIM на SIM/ATM
Превалидация платежа
Метод позволяет проверить корректость заполненных данных, а также получить информацию о комиссии по переводу.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| commission | array | Информация о комиссии |
| commission.calc | integer | Расчёт комиссии (фиксированный или процент) |
| commission.percent | float | Процент комиссии |
| commission.minimum | float | Минимальная комиссия |
| commission.fixed | float | Фиксированная комиссия |
| commission.amount | float | Сумма комиссии |
Headers
Headers
Перевод на банкомат
Инициализация платежа на банкомат
Система МФС позволяет осуществлять вывод денег с баланса абонента на банкоматы АО «Халык Банк». Сервис предоставляется только идентифицированным владельцам электронных кошельков.
Вывод средств происходит в 2 этапа: 1. Списание средств с баланса абонента. 2. Изъятие денег абонентов из банкомата.
В случае, если первый этап был успешный, но клиент не забрал деньги из банкомата в течение 24-х часов, операция отменяется и деньги возвращаются клиенту.
Метод позволяет инициировать платеж. Возвращает данные о комиссии и информацию о подтверждении платежа.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | integer | Сумма выплаты |
| payment.commission_amount | float | Сумма комисии |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
Headers
Headers
Перевод на SIM
Инициализация платежа на SIM
Метод позволяет инициировать платеж. Возвращает данные о комиссии и информацию о подтверждении платежа.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.amount | integer | Сумма выплаты |
| payment.commission_amount | float | Сумма комисии |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
Headers
Headers
Подтверждение выплаты
Подтверждение выплаты
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| confirm_inputs | object | Нет | Объект содержит поля, которые требуется передать для подтверждения платежа. Должен содержать как минимум один ключ и значение. |
| confirm_inputs.otp | string | Нет | OTP код, если был запрошен |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| payment.id | integer | ID платежа |
| payment.status | string | Статус платежа из Таблицы 3 |
| payment.receipt_url | string | Ссылка страницу просмотра и скачивания чека |
| payment.amount | float | Сумма выплаты |
| payment.commission_amount | float | Сумма комиссии |
Headers
Headers
Отправка OTP кода
Метод должен быть вызван в том случае, если при инициализации вернулся ответ с запросом подтверждения через OTP или если предыдущий OTP код устарел.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
Headers
Headers
Получение статуса
Подтверждение выплаты
Метод позволяет проверить статус платежа.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
Параметры ответа
Headers
Headers
С карты на SIM
Перевод средств с карты на баланс мобильного номера телефона осуществляется путём вызова соответствующего фрейма для заполнения данных карты плательщика с передачей номера телефона получателя и суммы для пополнения.
После успешного списания средств с карты плательщика происходит пополнение баланса телефона.
О результате перевода средств система уведомляет мерчанта путём вызова соответствующего URL (success, failure).
Предвалидация данных
Перед проведением перевода с карты на SIM необходимо отправить данные на предварительную валидацию данных. В случае, если данному мерчанту доступен перевод с карты на баланс указанного номера телефона, в ответе на запрос придёт информация о комиссии.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| operator | string | Код мобильного оператора указанного номера телефона |
| commission | array | Информация о комиссии |
| commission.calc | integer | Расчёт комиссии (фиксированный или процент) |
| commission.percent | float | Процент комиссии |
| commission.minimum | float | Минимальная комиссия |
| commission.fixed | float | Фиксированная комиссия |
| commission.amount | float | Сумма комиссии |
Headers
Headers
Получение ссылки на фрейм
Получение ссылки на фрейм
Запрос ссылки на фрейм осуществляется с теми же данными, которые отправляются на предварительную валидацию.
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| url | string | Ссылка на фрейм для вызова для ввода данных карты |
Headers
Headers
С SIM на карту
Перевод средств с баланса мобильного номера телефона на карту осуществляется путём вызова соответствующего фрейма для заполнения данных карты получателя с передачей номера телефона плательщика и суммы для пополнения.
После успешного списания средств с баланса телефона плательщика происходит пополнение карты.
О результате перевода средств система уведомляет мерчанта путём вызова соответствующего URL (success, failure).
Предвалидация данных
Перед проведением перевода с SIM на карту необходимо отправить данные на предварительную валидацию данных. В случае, если данному мерчанту доступен перевод с баланса указанного номера телефона на карту, в ответе на запрос придёт информация о комиссии.
Параметры запроса
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| operator | string | Код мобильного оператора указанного номера телефона |
| commission | array | Информация о комиссии |
| commission.calc | integer | Расчёт комиссии (фиксированный или процент) |
| commission.percent | float | Процент комиссии |
| commission.minimum | float | Минимальная комиссия |
| commission.fixed | float | Фиксированная комиссия |
| commission.amount | float | Сумма комиссии |
Headers
Headers
Иницализация выплаты
Получение ссылки на фрейм
Инициализация платежа с баланса номера телефона на карту осуществляется с теми же данными, которые отправляются на предварительную валидацию.
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| id | integer | Идентификатор платежа на списание с баланса |
| confirm_inputs | array | Массив содержит список объектов с полями, которые требуется отправить в подтверждении платежа (пункт 4.6) |
| confirm_inputs.name | string | Название поля для отображения пользователю |
| confirm_inputs.value | string | Название поля для отправки в методе подтверждения |
После инициализации платежа необходимо вызвать метод отправки OTP-кода (соответствующий метод описан в документации к группе «Переводы / V2 / С SIM»).
Headers
Headers
Подтверждение платежа
Получение ссылки на фрейм
Подтверждение перевода требует ввода OTP-кода. В случае успешного ввода система возвращает ссылку на фрейм для ввода номера карты.
Параметры запроса
| Параметр | Тип / требования | Обязательный | Описание / пример |
|---|---|---|---|
| id | integer | Да | ID платежа в системе МФС |
| confirm_inputs | object | Нет | Объект содержит поля, которые требуется передать для подтверждения платежа. Должен содержать как минимум один ключ и значение. |
| confirm_inputs.otp | string | Нет | OTP код, если был запрошен |
Параметры ответа
| Параметр | Тип | Описание |
|---|---|---|
| status | string | Статус выполнения запроса из Таблицы 2 |
| code | integer | Код ответа из Приложения 1 |
| dt | datetime | Дата и время обработки запроса |
| url | string | Ссылка на фрейм для вызова для ввода данных карты |
Headers
Headers
Прочее
Post back
URL указанный в параметре result_url будет вызван после проведения платежа или в случае ошибки методом POST, если этот параметр указан. Запрос инициирует МФС. Ожидается получение от сервиса пустого тела ответа и HTTP код 200.
Параметры запроса
| Параметр | Тип / требования | Описание / пример |
|---|---|---|
| order_id | string | ID заказа мерчанта |
| payment_id | integer | ID платежа в системе МФС |
| dt | datetime | Дата и время обработки запроса |
| status | string | Статус платежа, таблица 3 |
Приложение 1. Коды ошибок
Таблица содержит все коды ошибок.
| Код | Описание |
|---|---|
| 601 | Неверный проверочный код |
| 602 | Абонент не может оплатить |
| 603 | (Динамическое описание) |
| 604 | Слишком много попыток проверки |
| 605 | Слишком много попыток отправки sms |
| 607 | Дневной лимит платежей в размере 100 МРП исчерпан |
| 608 | Неверный статус транзакции для OTP-верификации |
| 609 | Срок действия кода подтверждения истек |
| 610 | Вы превысили суточный лимит в размере 50МРП. Попробуйте позднее. |
| 611 | Минимальная сумма платежа 1000тг |
| 801 | Провайдер платежей не установлен |
| 802 | Магазин недоступен |
| 803 | Комиссии не найдены |
| 803 | Платежная система не установлена |
| 808 | Мерчант не найден. Требуется создать транзакцию повторно |
| 809 | Аккаунт не найден в системе поставщика |
| 1000 | Нет ошибок |
| 2000 | Терминал не найден |
| 2001 | Магазин заблокирован |
| 2002 | Аккаунт заблокирован |
| 2003 | Платежная система не найдена |
| 2004 | Действие не разрешено |
| 2005 | Транзакция не подтверждена |
| 2006 | Неверный статус платежа |
| 2007 | Аккаунт платежной системы не установлен |
| 2008 | Баланс аккаунта не установлен |
| 2009 | Платежная система не установлена |
| 2010 | Ошибка обработки запроса. Попробуйте позднее |
| 2011 | Транзакция уже существует |
| 2012 | Транзакция не найдена |
| 2013 | Неверный тип транзакции |
| 2014 | Источник платежа не найден |
| 2015 | Оператор не найден |
| 2016 | Тип платежной системы не найден |
| 2017 | Время жизни платежа превышено |
| 2018 | Непредвиденная ошибка транзакции. Обновите страницу и попробуйте еще раз. |
| 2019 | Недостаточно баланса |
| 2020 | Этой суммы недостаточно |
| 2021 | Ошибка при получение ответа от биллинга |
| 2022 | Транзакция не завершена |
| 2023 | Платеж уже существует |
| 2030 | Сервис недоступен. Обратитесь к оператору связи |
| 3000 | Непредвиденная ошибка приложения |
| 3001 | Ошибка SMS шлюза |
| 3002 | Критическая ошибка приложения со стороны провайдера |
| 3003 | Некритическая ошибка приложения со стороны провайдера |
| 3004 | Платеж отклонен биллинговой системой. Просим обратиться к провайдеру связи |
| 3005 | Ошибка перевода. Попробуйте повторить позднее. |
| 3006 | Номер абонента не соответствует условиям предоставления сервиса. |
| 3007 | Номер абонента-отправителя не соответствует условиям предоставления сервиса. |
| 3008 | Номер абонента-отправителя введен неверно |
| 3009 | Номер абонента-получателя введен неверно |
| 3010 | Сумма введена неверно |
| 3011 | Не достаточно средств. При совершении мобильного перевода на балансе должно оставаться не менее 100тг |
| 3012 | Недостаточно средств для совершения операции |
| 3013 | Имеется непогашенная задолженность по услуге «Доверительный платеж» |
| 3014 | Ограничение оператора: Абонент потратил менее 500 тенге |
| 9999 | Общая ошибка системы |
Приложение 2. Таблицы
Таблица 1. Типы платежей
| Поле | Описание |
|---|---|
| refill | Пополнение баланса абонента |
| pay | Списание с баланса абонента |
| revoke | Отмена платежа |
| refund | Возврат платежа |
| transfer | Перевод между балансами абонентов |
Таблица 2. Статусы ответа
| Поле | Описание |
|---|---|
| need_approve | Необходимо подтверждение |
| error | Ошибка |
| success | Успешно завершен |
Таблица 3. Статусы платежей
| Поле | Описание |
|---|---|
| new | Новый заказ |
| process | В обработке |
| error | Ошибка проведения заказа |
| success | Успешно завершен |
Таблица 4. Типы выплат
| Поле | Описание |
|---|---|
| atm | Выплата на банкомат |
Тестовые номера телефонов
Механика мобильной коммерции подразумевает тестирование в рамках ряда операторов.
Ниже предоставлены номера и соответствующие им OTP-коды для проведения тестов.
Список номеров:
| Оператор | Номер телефона | OTP код |
|---|---|---|
| Кселл | 77017777777 | 111111 |
| Актив | 77027777777 | 111111 |
| Теле2 | 77037777777 | 111111 |
| Алтел | 77047777777 | 111111 |
Режим тестирования
В процессе тестирования вам может потребоваться эмуляция работы сервиса. Для этого вы можете воспользоваться передачей флага testmode со следующими значениями:
