МТС Деньги
Для приема платежей с помощью данного альтернативного способа оплаты вам необходимо:
- Отправить запрос проверки подключения услуги "МТС Деньги" у клиента.
- Отправить запрос на оплату на указанную клиентом сумму.
Шаг | Описание |
---|---|
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 | Неправильный номер телефона | Неправильный номер телефона |