Multibanco
Вариант интеграции EPA
Оплата
Процесс оплаты
- Покупатель выбирает Multibanco в качестве способа оплаты на сайте торговца.
- Торговец отправляет запрос оплаты в PaySage.io.
- PaySage.io присылает в ответе секцию
multibanco
с параметрамиaccount_number
иaccount_code
. - Торговец отображает покупателю полученные значения параметров
account_number
(Reference) иaccount_code
(Entity), а также инструкцию о том, как завершить оплату. - Покупатель совершает оплату, используя полученные значения.
- Если оплата прошла успешно, PaySage.io высылает торговцу автоматическое уведомление со статусом
successful
. - Если оплата не была совершена в течение трех часов после ответа на запрос оплаты, PaySage.io высылает торговцу автоматическое уведомление со статусом
expired
. - Если оплата совершена позднее, чем 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
Описание процесса оплаты
- Покупатель инициирует оплату на странице торговца.
- Торговец отправляет запрос оплаты в PaySage.io.
- PaySage.io присылает в ответе параметры для формирования HTML формы для завершения оплаты.
- Торговец перенаправляет покупателя на форму для завершения оплаты.
- Покупатель завершает оплату.
- 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 | Номер телефона покупателя. |
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"
}
]
}
}
}