Перейти к содержанию

МТС Деньги 2

Для приема платежей с помощью данного альтернативного способа оплаты вам необходимо:

  1. Отправить запрос проверки подключения услуги "МТС Деньги" у покупателя.
  2. Отправить запрос на оплату на указанную покупателем сумму.

Схема приема оплаты через "МТС Деньги"

Шаг Описание
1 Покупатель выбирает "МТС Деньги" как способ оплаты.
2 Торговец отправляет запрос проверки подключения услуги у покупателя.
3 Система bePaid отправляет запрос проверки в систему "МТС Деньги".
4 "МТС Деньги" информирует bePaid, подключена ли услуга у покупателя.
5 bePaid присылает торговцу ответ с результатом проверки, указанным как значение параметра service_activated.
6 Покупатель указывает сумму к оплате, соглашается с Правилами сервиса, если требуется, и нажимает кнопку "Оплатить" для завершения оплаты.
7 Торговец отправляет запрос на оплату.
8 bePaid отправляет торговцу ответ со статусом pending, который означает, что запрос на оплату находится в процессе обработки.
9 bePaid формирует и направляет запрос на оплату в "МТС Деньги".
10 После обработки платежа система "МТС Деньги" передает bePaid статус платежа.
11 Система bePaid уведомляет торговца о статусе транзакции.

Проверка активации сервиса

Запрос

Чтобы проверить, является ли покупатель участником сервиса "МТС Деньги", отправьте POST запрос на https://api.bepaid.by/beyag/gateways/mts_money_widget/check_service с дополнительным заголовком X-API-Version: 2 и следующими параметрами:

Параметр Тип данных Описание
customer object Секция информации о покупателе.
phone * обязательный
 string Полный номер телефона клиента с кодом страны и без знака +. Например, 375291112233.
Пример запроса проверки 
{
    "request":{
        "test": true,
        "customer":{
            "phone":"375295222222"
        }
    }
}

Чтобы проверить, является ли покупатель участником сервиса "МТС Деньги", отправьте POST запрос на https://api.bepaid.by/beyag/gateways/mts_money_widget/check_service с дополнительным заголовком X-API-Version: 3 и следующими параметрами:

Параметр Тип данных Описание
customer object Секция информации о покупателе.
phone * обязательный
 string Полный номер телефона покупателя с кодом страны и без знака +. Например, 375291112233.
Пример запроса проверки 
{
    "request":{
        "test": true,
        "customer":{
            "phone":"375295222222"
            }
        }
}
Ответ

Ответ на запрос проверки содержит следующие параметры:

Параметр Тип данных Описание
service_activated * обязательный
 boolean Результат проверки активации сервиса.
Возможные значения:
true - услуга "МТС Деньги" у покупателя подключена ранее. Торговец может не запрашивать согласие покупателя с Правилами сервиса;
false - услуга "МТС Деньги" у покупателя еще не подключена. Для ее подключения торговцу следует запросить согласие покупателя с Правилами сервиса;
null - Введенный номер не принадлежит оператору MTC. Проверка услуги не выполнена.
message * обязательный
 string Сообщение системы МТС.
validation * обязательный
 object Секция с результатами проверки принадлежности номера оператору MTC.
operator string Мобильный оператор введенного номера телефона.
Возможные значения:
mts - Оператор MTC,
other - Оператор не MTC;
null - Номер телефона введен в неверном формате.
message string Информационное сообщение системы.
Пример успешного ответа на запрос проверки API v.2 
{
 "service_activated": true,
 "message": "Request successfully processed",
 "validation": {
    "operator": "mts",    
    "message": "Request successfully processed" 
 }
}
Пример ответа на запрос проверки API v.2. Номер МТС, услуга МТС Деньги не подключена. 
{
    "service_activated": false,
    "message": "Request successfully processed",
    "validation": {
        "operator": "mts",
        "message": "Request successfully processed"
    },
    "error_code": "service_not_activated"
}
Пример неуспешного ответа на запрос проверки API v.2. Неверный формат номера телефона. Проверка активации сервиса не выполнена. 
{
    "service_activated": null,
    "message": null,
    "validation": {
        "operator": "other",
        "message": "Request successfully processed"
    },
    "error_code": "account_not_found"
}

Ответ на запрос проверки содержит следующие параметры:

Параметр Тип данных Описание
code * обязательный
 string Код обработанной транзакции
status * обязательный
 string Статус проверки.
message * обязательный
 string Сообщение системы МТС.
friendly message * обязательный
 string Сообщение системы для покупателя.
Пример успешного ответа на запрос проверки API v.3 
{
    "code": "S.0000",
    "status": "successful",
    "message": "The operation was successfully processed",
    "friendly_message": "Successfully processed"        
}
Пример ответа на запрос проверки API v.3. Номер МТС, услуга МТС Деньги не подключена. 
{
    "code": "F.0213",
    "status": "failed",
    "message": "Нет разрешения: Обратитесь к провайдеру платежных услуг для уточнения причины.",
    "friendly_message": "Нет разрешения: Не удалось завершить транзакцию. Обратитесь к продавцу для уточнения причин или используйте другой способ оплаты."
}
Пример неуспешного ответа на запрос проверки API v.3. Неверный формат номера телефона. Проверка активации сервиса не выполнена. 
{
    "code": "F.0202",
    "status": "failed",
    "message": "Аккаунт не найден: Не удалось завершить транзакцию. Проверьте параметры запроса.",
    "friendly_message": "Аккаунт не найден: Не удалось завершить транзакцию. Обратитесь к провайдеру способа оплаты для уточнения причины."       
}

Оплата

Запрос

Отправьте запрос оплаты со следующими дополнительными данными:

Параметр Тип данных Описание
return_url * обязательный
 string URL, на который будет возвращен покупатель после завершения транзакции.
notification_url string URL, на который торговец будет получать уведомления об оплате. Если не указан, уведомления не высылаются.
method object Секция параметров способа оплаты.
type * обязательный
 string mts_money
confirm_agreement * обязательный
 string Возможные значения:
already_accepted - услуга "МТС Деньги" была подключена ранее;
accept - услуга "МТС Деньги" не была подключена у покупателя. Покупатель готов ее подключить и дает согласие с Правилами сервиса;
decline - услуга "МТС Деньги" не была подключена у покупателя. Покупатель не готов ее подключить для завершения оплаты.
customer object Секция информации о покупателе.
phone * обязательный
 string Полный номер телефона покупателя с кодом страны и без знака +. Например, 375291112233.
Пример запроса оплаты 
{
  "request": {
    "amount": 100,
    "currency": "BYN",
    "description": "description",
    "test": true,
    "expired_at": "2025-01-01T15:00:00+01:00",
    "tracking_id": "your_uniq_number",
    "return_url": "https://your_shop_URL.by/",
    "customer": {
      "phone": "375295222222"
    },
    "method": {
      "type": "mts_money",
      "confirm_agreement": "accept"
    }
  }
}
Ответ

Секция mts_money из ответа на запрос будет иметь все те же параметры, что были присланы в запросе. Статус транзакции будет указан как pending, пока запрос оплаты будет находиться в процессе обработки.

Пример ответа со статусом транзакции pending 
{
  "transaction": {
    "uid": "8c5ba7da-a4de-4322-8eed-0f4acaf0b579",
    "type": "payment",
    "status": "pending",
    "amount": 100,
    "currency": "BYN",
    "description": "description",
    "created_at": "2024-05-17T11:25:30Z",
    "updated_at": "2024-05-17T11:25:30Z",
    "method_type": "mts_money",
    "receipt_url": "https://merchant.bepaid.by/customer/transactions/8c5ba7da-a4de-4322-8eed-0f4acaf0b579/83c4c06deb03de7a866885d41e747f1ba3f051f76dbfd5a14ab9c7d62aa7d068",
    "payment": {
      "status": "pending",
      "gateway_id": 3989,
      "message": "Transaction was initialized."
    },
    "mts_money": {
      "type": "mts_money",
      "confirm_agreement": "accept"
    },
    "customer": {
      "phone": "375295222222",
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": true,
    "billing_address": {
      "phone": "375295222222"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}

Уведомление о финальном статусе транзакции

Когда система "МТС Деньги" обработает платеж и уведомит bePaid, вы получите уведомление о финальном статусе транзакции на URL для уведомлений, указанный в запросе или в вашем личном кабинете bePaid.

Пример уведомления 
{
    "transaction": {
        "uid": "d5ac59da-09bf-4f82-826c-f9f96d3fb4ba",
        "type": "payment",
        "status": "successful",
        "amount": 100,
        "currency": "BYN",
        "description": "description",
        "created_at": "2022-03-20T11:44:30Z",
        "updated_at": "2022-03-20T11:44:36Z",
        "method_type": "mts_money",
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/d5ac59da-09bf-4f82-826c-f9f96d3fb4ba/0abb8ceeea66e8bc323cdfa5268efc67905de11cf775a525acf70ba73cafd112?language=en",
        "payment": {
            "status": "successful",
            "gateway_id": 395,
            "message": "Transaction was successfully processed."
        },
        "mts_money": {
            "type": "mts_money",
            "confirm_agreement": "accept"
        },
        "customer": {
            "phone": "375295222222",
            "last_name": "Doe",
            "first_name": "John",
            "ip": "127.0.0.1"
        },
        "message": "Transaction was successfully processed.",
        "tracking_id": "your_uniq_number",
        "test": true,
        "language": "en",
        "paid_at": "2022-03-20T11:44:36Z",
        "billing_address": {
            "phone": "375295222222",
            "last_name": "Doe",
            "first_name": "John",
            "ip": "127.0.0.1"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }
    }
}

Тестирование

Для тестирования добавьте test: true к параметрам запроса и используйте следующие тестовые номера телефонов:

Номер телефона Результат для запроса проверки Результат для запроса оплаты
375295222222 Услуга активна Успешная оплата
375295111111 Услуга неактивна Неуспешная оплата
375444111111 Неправильный номер телефона Неправильный номер телефона
375290000000 Номер телефона - МТС. Услуга МТС Деньги подключена Недостаточно средств