МТС Деньги

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

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

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

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

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

Запрос

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

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

Пример запроса проверки

{
"request":{
    "test": true,
    "customer":{
        "phone":"375295222222"
    }
}
}

Ответ

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

Параметр	Тип данных	Описание
service_activated	boolean	Результат проверки активации сервиса. Возможные значения: `true` - услуга "МТС Деньги" у клиента подключена ранее. Торговец может не запрашивать согласие клиента с Правилами сервиса; `false` - услуга "МТС Деньги" у клиента еще не подключена. Для ее подключения торговцу следует запросить согласие клиента с Правилами сервиса.
message * обязательный	string	Информационное сообщение системы.
error	string	Информационное сообщение системы об ошибке.

Пример ответа на запрос проверки

{
"service_activated": true,
"message": "Request successfully processed"

}

Оплата

Запрос

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

Параметр	Тип данных	Описание
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": "2023-01-01T15:00:00+01:00",
    "tracking_id":"your_uniq_number",
    "ip":"127.0.0.1",
    "language":"en",
    "return_url": "https://your_shop_URL.by/",
    "customer":{
        "first_name":"John",
        "last_name":"Doe",
        "phone":"375295222222"
    },
    "method":{
        "type": "mts_money",
        "confirm_agreement": "accept"
    }
}
}

Ответ

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

Пример ответа со статусом транзакции pending

{
    "transaction": {
        "uid": "d5ac59da-09bf-4f82-826c-f9f96d3fb4ba",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "BYN",
        "description": "description",
        "created_at": "2022-03-20T11:44:30Z",
        "updated_at": "2022-03-20T11:44:30Z",
        "method_type": "mts_money",
        "receipt_url": "https://merchant.bepaid.by/customer/transactions/d5ac59da-09bf-4f82-826c-f9f96d3fb4ba/0abb8ceeea66e8bc323cdfa5268efc67905de11cf775a525acf70ba73cafd112?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 395,
            "message": "Transaction was initialized."
        },
        "mts_money": {
            "type": "mts_money",
            "confirm_agreement": "accept"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "phone": "375295222222",
            "ip": "127.0.0.1"
        },
        "message": "Transaction was initialized.",
        "tracking_id": "your_uniq_number",
        "test": true,
        "language": "en",
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "phone": "375295222222",
            "ip": "127.0.0.1"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }
    }
}

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

Когда система "МТС Деньги" обработает платеж и уведомит 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	Неправильный номер телефона	Неправильный номер телефона