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

MB WAY

Вариант интеграции EPA

Процесс оплаты

  1. Покупатель выбирает MB WAY в качестве способа оплаты на сайте торговца.
  2. Торговец отображает покупателю поле для ввода номера телефона либо поле с раннее введенным номером телефона.
  3. Покупатель вводит свой номер телефона или редактирует отображенный номер телефона при необходимости.
  4. Торговец отправляет запрос оплаты в PaySage.io.
  5. Покупатель получает уведомление с PIN-кодом транзакции в своем приложении MB WAY.
  6. Покупатель подтверждает оплату в приложении MB WAY с помощью PIN-кода или другим доступным способом.
  7. PaySage.io высылает торговцу автоматическое уведомление со статусом транзакции.
  8. Торговец отображает покупателю статус оплаты.

Оплата

Запрос

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

Параметр Тип данных Описание
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

Описание процесса оплаты

  1. Покупатель инициирует оплату на странице торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
  4. Торговец перенаправляет покупателя на форму для завершения оплаты.
  5. Покупатель завершает оплату.
  6. 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 Номер телефона покупателя.
email 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"
                }
            ]
        }
    }
}