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

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.
Запрос

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

object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
multibanco
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
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 высылает торговцу автоматическое уведомление со статусом оплаты.

Оплата

Запрос

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

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

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

Оплата

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

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

Info

Этот вариант интеграции поддерживает только валюту EUR.

Запрос

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

object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
multibanco_redirect
ip
 string
IP-адрес покупателя.
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
phone
 string
Номер телефона покупателя.
email
 string
Адрес электронной почты покупателя.
city
 string (120)
Город покупателя.
zip
 string (40)
Почтовый индекс покупателя.
birth_date
 string
Дата рождения покупателя в формате ISO-8601 (YYYY-MM-DD).
address
 string (510)
Адрес покупателя.
Пример ответа 
{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return.com",
        "language": "en",
        "customer": {
            "first_name": "John",
            "last_name": "Doe"
        },
        "method": {
            "type": "multibanco_redirect"
        }
    }
}
Ответ

Отправьте покупателя на URL, указанный в параметре form.action.

Пример ответа 
{
    "transaction": {
        "uid": "4b10733a-1327-45f0-b909-1ecd8bf6fefa",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-09-17T12:10:55Z",
        "updated_at": "2025-09-17T12:10:56Z",
        "method_type": "multibanco_redirect",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/4b10733a-1327-45f0-b909-1ecd8bf6fefa/54cf8309584a098eab4f1c5eb2fae9ffab633d2445e07d438aa16e22d571fa0f?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5220,
            "ref_id": "01505e9fb7884cd15b5d",
            "message": "Transaction was initialized."
        },
        "multibanco_redirect": {
            "type": "multibanco_redirect"
        },
        "customer": {
            "last_name": "Doe",
            "first_name": "John",
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "language": "en",
        "billing_address": {
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link_to_payment_page",
            "fields": [],
            "method": "GET"
        }
    }
}

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

Оплата

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

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

Info

Этот вариант интеграции поддерживает только валюту EUR.

Запрос

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

object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения транзакции в платёжной системе.
ip
обязательный
 string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
multibanco_redirect
object
Секция информации о покупателе.
external_id
 string (64)
Уникальный идентификатор покупателя в системе торговца.
first_name
 string (50)
Имя покупателя.
last_name
 string (50)
Фамилия покупателя.
email
обязательный
 string
Адрес электронной почты покупателя.
phone
 string
Номер телефона покупателя.
country
обязательный
 string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PT.
city
 string (255)
Город покупателя.
address
 string (255)
Адрес покупателя.
zip
 string (10)
Почтовый индекс покупателя.
Пример запроса 
{
  "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": "multibanco_redirect"
    }
  }
}
Ответ

Отправьте покупателя на 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": "multibanco_redirect",
    "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."
    },
    "multibanco_redirect": {
      "type": "multibanco_redirect",
      "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"
    }
  }
}