MB WAY
Вариант интеграции EPA
Процесс оплаты
- Покупатель выбирает MB WAY в качестве способа оплаты на сайте торговца.
- Торговец отображает покупателю поле для ввода номера телефона либо поле с раннее введенным номером телефона.
- Покупатель вводит свой номер телефона или редактирует отображенный номер телефона при необходимости.
- Торговец отправляет запрос оплаты в PaySage.io.
- Покупатель получает уведомление с PIN-кодом транзакции в своем приложении MB WAY.
- Покупатель подтверждает оплату в приложении MB WAY с помощью PIN-кода или другим доступным способом.
- PaySage.io высылает торговцу автоматическое уведомление со статусом транзакции.
- Торговец отображает покупателю статус оплаты.
Оплата
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
Параметр | Тип данных | Описание |
---|---|---|
request | object | |
return_url * обязательный |
string | URL, на который будет возвращен покупатель после завершения операции в платёжной системе. |
method | object | Секция параметров способа оплаты. |
type * обязательный |
string | mb_way |
customer | object | Секция информации о покупателе. |
first_name * обязательный |
string | Имя покупателя. |
last_name * обязательный |
string | Фамилия покупателя. |
email * обязательный |
string | Адрес электронной почты покупателя. |
phone * обязательный |
string (9) | Номер телефона покупателя без кода страны. |
Пример запроса
{
"request":{
"amount":100,
"currency":"EUR",
"description":"description",
"return_url": "https://your_return_url.com",
"test": false,
"customer":{
"first_name": "John",
"last_name": "Doe",
"email": "john@example.com",
"phone":"123456789"
},
"method":{
"type": "mb_way"
}
}
}
Ответ
Пример ответа
{
"transaction": {
"uid": "fafd92cd-e48d-48f2-aec2-4671850fe52d",
"type": "payment",
"status": "pending",
"amount": 100,
"currency": "EUR",
"description": "description",
"created_at": "2023-11-15T08:37:10Z",
"updated_at": "2023-11-15T08:37:13Z",
"method_type": "mb_way",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/fafd92cd-e48d-48f2-aec2-4671850fe52d/52d2f47ea5aa481a02970b6a44fad0dca3d074589133c9870f0bb79d920d7689",
"payment": {
"status": "pending",
"gateway_id": 3403,
"ref_id": "116588",
"message": "Pending"
},
"mb_way": {
"type": "mb_way"
},
"customer": {
"phone": "912345678",
"email": null,
"ip": null
},
"manually_corrected_at": null,
"message": "Pending",
"test": true,
"billing_address": {
"phone": "912345678"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
}
}
}
Вариант интеграции TW2
Описание процесса оплаты
- Покупатель инициирует оплату на странице торговца.
- Торговец отправляет запрос оплаты в PaySage.io.
- PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
- Торговец перенаправляет покупателя на форму для завершения оплаты.
- Покупатель завершает оплату.
- PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.
Info
Этот вариант интеграции поддерживает только валюту EUR
.
Оплата
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
Параметр | Тип данных | Описание |
---|---|---|
request | object | |
amount * обязательный |
bigInteger | Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро). |
return_url * обязательный |
string | URL, на который будет возвращен покупатель после завершения операции в платёжной системе. |
method | object | Секция параметров способа оплаты. |
type * обязательный |
string | mb_way |
ip | string | IP-адрес покупателя. |
customer | object | Секция информации о покупателе. |
country | string | Страна покупателя в формате ISO 3166-1 alpha-2. Например, PT . |
phone | string | Номер телефона покупателя. |
string | Адрес электронной почты покупателя. | |
first_name | string | Имя покупателя. |
last_name | string | Фамилия покупателя. |
city | string (120) | Город покупателя. |
zip | string (40) | Почтовый индекс покупателя. |
state | string | Двухбуквенная аббревиатура штата, если страна покупателя US , CA или IN . |
address | string (510) | Адрес покупателя. |
Пример запроса
{
"request": {
"amount": 101,
"currency": "EUR",
"description": "test",
"test": false,
"tracking_id": "your_uniq_number21212",
"return_url": "https://your-success.url",
"method": {
"type": "mb_way"
}
}
}
Ответ
Создайте HTML-форму, используя параметры из секции form
. Отправьте покупателя на форму для завершения оплаты.
Пример ответа
{
"transaction": {
"uid": "52878f4b-a1c6-428d-86cd-162e0111d98b",
"type": "payment",
"status": "pending",
"amount": 101,
"currency": "EUR",
"description": "test",
"created_at": "2025-04-08T12:23:18Z",
"updated_at": "2025-04-08T12:23:18Z",
"method_type": "mb_way",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/52878f4b-a1c6-428d-86cd-162e0111d98b/34aebab9cef3e3332763eb8db16a2439cfe949ccf0bbbfd5a9a127f691dfa8b4",
"payment": {
"status": "pending",
"gateway_id": 5236,
"message": "Transaction was initialized."
},
"mb_way": {
"type": "mb_way"
},
"customer": {
"email": null,
"ip": null
},
"manually_corrected_at": null,
"version": 0,
"message": "Transaction was initialized.",
"tracking_id": "your_uniq_number21212",
"test": false,
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"method": "POST",
"fields": [
{
"name": "memberId",
"value": "14363",
"type": "hidden"
},
{
"name": "terminalid",
"value": "8162",
"type": "hidden"
},
{
"name": "partnerId",
"value": "39",
"type": "hidden"
},
{
"name": "checksum",
"value": "d8d54ea74563444eff6e2db308247737",
"type": "hidden"
},
{
"name": "merchantTransactionId",
"value": "52878f4b-a1c6-428d-86cd-162e0111d98b",
"type": "hidden"
},
{
"name": "amount",
"value": "1.01",
"type": "hidden"
},
{
"name": "currency",
"value": "EUR",
"type": "hidden"
},
{
"name": "paymentBrand",
"value": "MBWAY",
"type": "hidden"
},
{
"name": "paymentMode",
"value": "EW",
"type": "hidden"
},
{
"name": "orderDescription",
"value": "test",
"type": "hidden"
},
{
"name": "country",
"value": "PT",
"type": "hidden"
},
{
"name": "merchantRedirectUrl",
"value": "https://api.paysage.io/beyag/transactions/returns/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/52878f4b-a1c6-428d-86cd-162e0111d98b",
"type": "hidden"
},
{
"name": "notificationUrl",
"value": "https://api.paysage.io/beyag/transactions/notifications/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/52878f4b-a1c6-428d-86cd-162e0111d98b",
"type": "hidden"
},
{
"name": "totype",
"value": "TransactWorld",
"type": "hidden"
}
]
}
}
}