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"
}
]
}
}
}
Вариант интеграции CA
Оплата
Процесс оплаты
- Покупатель инициирует оплату на сайте торговца.
- Торговец отправляет PaySage.io запрос оплаты.
- PaySage.io присылает в ответе торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель завершает платёж.
- PaySage.io высылает торговцу автоматическое уведомление.
Info
Этот вариант интеграции поддерживает только валюту EUR.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 1010,
"currency": "EUR",
"description": "description",
"skip_duplicate_check": true,
"test": false,
"tracking_id": "189",
"notification_url": "https://notification-url",
"return_url": "https://return-url",
"ip": "127.0.0.1",
"language": "en",
"customer": {
"first_name": "John",
"last_name": "Doe",
"country": "PT",
"city": "Lisbon",
"zip": "1100-105",
"email": "john@example.com",
"address": "1st Street",
"phone": "17777777777",
"external_id": "123bh7"
},
"method": {
"type": "mb_way"
}
}
}
Ответ
Отправьте покупателя на URL, указанный в параметре form.action.
Пример ответа
{
"transaction": {
"uid": "b9265cbb-1a18-4276-ba32-7508a93eec4d",
"type": "payment",
"status": "pending",
"amount": 1010,
"currency": "EUR",
"description": "description",
"created_at": "2026-04-23T13:57:16Z",
"updated_at": "2026-04-23T13:57:16Z",
"method_type": "mb_way",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/b9265cbb-1a18-4276-ba32-7508a93eec4d/3d8e6b0e0d2a8ef787d70cc3d150496681e7a1b388f4602c36e41e77cb37c673?language=en",
"payment": {
"status": "pending",
"gateway_id": 6539,
"ref_id": "ca096dc9-4924-4b67-869f-2ed3ace1c579",
"message": "Transaction was initialized."
},
"mb_way": {
"type": "mb_way",
"use_pending_page": true
},
"customer": {
"zip": "1100-105",
"city": "Lisbon",
"email": "john@example.com",
"phone": "17777777777",
"address": "1st Street",
"country": "PT",
"last_name": "Doe",
"first_name": "John",
"external_id": "123bh7",
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 2,
"message": "Transaction was initialized.",
"tracking_id": "189",
"test": false,
"language": "en",
"billing_address": {
"zip": "1100-105",
"city": "Lisbon",
"email": "john@example.com",
"phone": "17777777777",
"address": "1st Street",
"country": "PT",
"last_name": "Doe",
"first_name": "John"
},
"additional_data": {
"payment_method": {
"type": "alternative"
}
},
"smart_routing_verification": {
"status": "successful"
},
"gateway": {
"iframe": false
},
"form": {
"action": "link-to-payment-page",
"fields": [],
"method": "GET"
}
}
}