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

Multibanco

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

Оплата

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

  1. Покупатель выбирает Multibanco в качестве способа оплаты на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе секцию multibanco с параметрами account_number и account_code.
  4. Торговец отображает покупателю полученные значения параметров account_number (Reference) и account_code (Entity), а также инструкцию о том, как завершить оплату.
  5. Покупатель совершает оплату, используя полученные значения.
  6. Если оплата прошла успешно, PaySage.io высылает торговцу автоматическое уведомление со статусом successful.
  7. Если оплата не была совершена в течение трех часов после ответа на запрос оплаты, PaySage.io высылает торговцу автоматическое уведомление со статусом expired.
  8. Если оплата совершена позднее, чем 3 часа после ответа на запрос оплаты, PaySage.io высылает торговцу повторное автоматическое уведомление со статусом successful.
Запрос

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

Параметр Тип данных Описание
request object
return_url * обязательный
string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
string multibanco
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": true,
        "method":{
            "type": "multibanco"
        },
        "customer":{
            "first_name": "John",
            "last_name": "Doe",
            "email": "john@example.com",
            "phone":"123456789"       
        }
    }
}
Ответ

Ответ будет содержать секцию multibanco с параметрами account_number and account_code

Параметр Тип данных Описание
multibanco object
account_number * обязательный
string Идентификатор счета для получения платежа. Значение для ввода в поле Reference при оплате в банкомате или приложении.
account_code * обязательный
string Организация, владелец счета для получения платежа. Значения для ввода в поле Entity при оплате в банкомате или приложении.
Пример ответа
{
    "transaction": {
        "uid": "faaec396-641a-489b-941e-00d53e66f995",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "created_at": "2023-11-15T06:51:55Z",
        "updated_at": "2023-11-15T06:51:57Z",
        "method_type": "multibanco",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/faaec396-641a-489b-941e-00d53e66f995/f65401e3dd21b16c5c48d93d0efe81fc1b9e88ca8875e2d50a6f4fbde1c08159",
        "payment": {
            "status": "pending",
            "gateway_id": 3403,
            "ref_id": "101323322",
            "message": "0 | OK",
            "bank_code": 0
        },
        "multibanco": {
            "account_number": "101323322",
            "account_code": "82142"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "message": "0 | OK",
        "test": true,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },        
        "gateway": {
            "iframe": false
        }
    }
}

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

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

  1. Покупатель инициирует оплату на странице торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
  4. Торговец перенаправляет покупателя на форму для завершения оплаты.
  5. Покупатель завершает оплату.
  6. PaySage.io высылает торговцу автоматическое уведомление со статусом оплаты.

Оплата

Запрос

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

Параметр Тип данных Описание
request object
amount * обязательный
bigInteger Сумма транзакции в минимальных денежных единицах, например, 5000 (50 евро).
return_url * обязательный
string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
string multibanco_redirect
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": "multibanco_redirect"
        }
    }
}
Ответ

Создайте HTML-форму, используя параметры из секции form. Отправьте покупателя на форму для завершения оплаты.

Пример ответа
{
    "transaction": {
        "uid": "c0ed1ea7-743b-4b31-8b5d-822bbf8eae46",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "test",
        "created_at": "2025-04-08T10:54:36Z",
        "updated_at": "2025-04-08T10:54:36Z",
        "method_type": "multibanco_redirect",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/c0ed1ea7-743b-4b31-8b5d-822bbf8eae46/1b02219693e9975c5b03978435cd1ed46d7fc0b0d12de0380d83df6e02381ca3",
        "payment": {
            "status": "pending",
            "gateway_id": 5236,
            "message": "Transaction was initialized."
        },
        "multibanco_redirect": {
            "type": "multibanco_redirect"
        },
        "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-url",
            "method": "POST",
            "fields": [
                {
                    "name": "memberId",
                    "value": "14363",
                    "type": "hidden"
                },
                {
                    "name": "terminalid",
                    "value": "8162",
                    "type": "hidden"
                },
                {
                    "name": "partnerId",
                    "value": "39",
                    "type": "hidden"
                },
                {
                    "name": "checksum",
                    "value": "56426a4923e7cd9a816b078cfd0aa2d0",
                    "type": "hidden"
                },
                {
                    "name": "merchantTransactionId",
                    "value": "c0ed1ea7-743b-4b31-8b5d-822bbf8eae46",
                    "type": "hidden"
                },
                {
                    "name": "amount",
                    "value": "1.00",
                    "type": "hidden"
                },
                {
                    "name": "currency",
                    "value": "EUR",
                    "type": "hidden"
                },
                {
                    "name": "paymentBrand",
                    "value": "MULTIBANCO",
                    "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/c0ed1ea7-743b-4b31-8b5d-822bbf8eae46",
                    "type": "hidden"
                },
                {
                    "name": "notificationUrl",
                    "value": "https://api.paysage.io/beyag/transactions/notifications/88c70e7191aa823ac0588a279d22ef5722fc26712f6eac23ab76b53a65019c48/c0ed1ea7-743b-4b31-8b5d-822bbf8eae46",
                    "type": "hidden"
                },
                {
                    "name": "totype",
                    "value": "TransactWorld",
                    "type": "hidden"
                }
            ]
        }
    }
}