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

Банковский перевод

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

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaySage.io.
  5. Покупатель выбирает банк на странице оплаты и совершает платеж.
  6. После завершения оплаты покупатель перенаправляется на return_url, указанный в запросе на оплату.
  7. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  8. Торговец отображает покупателю статус оплаты.

Оплата

Запрос

Отправьте запрос оплаты со следующими полями:
object
amount
обязательный
 bigInteger
Сумма в минимальных денежных единицах. Например, €32.45 должна быть отправлена как 3245.
currency
обязательный
 string
Валюта транзакции в формате ISO-4217 alpha-3 code. Допустимые значения: EUR или GBP.
description
обязательный
 string
Описание заказа.
notification_url
обязательный
 string
URL, на который торговец будет получать уведомления об оплате.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
Пример запроса 
{
    "request": {
        "amount": 20000,
        "currency": "EUR",
        "description": "description",
        "test": false,
        "return_url": "https://your_return_url.com",
        "notification_url": "https://your_notification_url.com",
        "method": {
            "type": "bank_transfer"
        }
    }
}
Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода на страницу оплаты. Направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа 
{
    "transaction": {
        "uid": "e567af49-da3b-463d-bc73-2514cf353564",
        "type": "payment",
        "status": "pending",
        "amount": 20000,
        "currency": "EUR",
        "description": "description",
        "created_at": "2023-10-06T14:12:36Z",
        "updated_at": "2023-10-06T14:12:36Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/21324-1544a58bfe/c3204e3e0df0bc30d675946b36e061091e19cb5c6e889d8e7ab1508666ff6ff5?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 3288,
            "ref_id": "tx_AOvyOzQ8x11HN40u1Gt0rkFn",
            "message": "Transaction was initialized"
        },
        "bank_transfer": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "manually_corrected_at": null,
        "message": "Transaction was initialized",
        "test": false,
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "https://my-integration-option.com/transactions/tx_AOvyOzQ8x11HN98u1Gt0rkFn",
            "method": "GET",
            "fields": []
        }
    }
}

Запрос статуса операции

Запрос

Если необходимо дополнительно узнать статус транзакции, отправьте запрос получения статуса.

Ответ

Ответ будет содержать статус транзакции, секцию параметров способа оплаты, а также иную информацию о транзакции согласно описанию запроса получения статуса платежа.

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

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaySage.io.
  5. Покупатель совершает платеж на странице оплаты.
  6. После завершения оплаты покупатель перенаправляется на return_url, указанный в запросе на оплату.
  7. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  8. Торговец отображает покупателю статус оплаты.

Оплата

Запрос

Info

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

Отправьте запрос оплаты со следующими дополнительными полями:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
city
обязательный
 string
Город покупателя.
state
обязательный
 string (2)
Штат покупателя. Укажите 2 последних символа из геокода формата ISO 3166-2.
zip
обязательный
 string (6)
Почтовый индекс покупателя.
address
обязательный
 string (510)
Адрес покупателя.
country
обязательный
 string
Страна покупателя в формате ISO 3166-1 alpha-2. Например, IN.
phone
обязательный

 string (10—14)
Номер мобильного или стационарного телефона покупателя. Примеры значений: 1234567891 или +91-1234567891
email
обязательный

 string
Адрес электронной почты покупателя.
Пример запроса 
{
  "request": {
    "amount": 20000,
    "currency": "INR",
    "description": "description",        
    "return_url": "return_url",
    "test": true,
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "city": "Bangalore",
      "state": "KA",
      "zip": "560002",
      "phone": "1234567891",
      "country": "IN",
      "email": "john@example.com",
      "address": "10 Sampige Road"
    },
    "method": {
      "type": "bank_transfer"
    }
  }
}
Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form со ссылкой для перехода на страницу оплаты. Направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа 
{
  "transaction": {
    "uid": "c4af9ca3-daf3-40cf-a19d-22c501e530d7",
    "type": "payment",
    "status": "pending",
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "created_at": "2024-02-07T10:04:00Z",
    "updated_at": "2024-02-07T10:04:01Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/c4af9ca3-daf3-40cf-a19d-22c501e530d7/9e63423487284dc87e9104489a86174c07ba08ad4f014fdc10f66d1f85d1a27b",
    "payment": {
      "status": "pending",
      "gateway_id": 3698,
      "ref_id": "1548e1ca-0d7c-4552-8139-728a04ccd6f5",
      "message": "Transaction was initialized"
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "country": "IN",
      "city": "Bangalore",
      "zip": "560002",
      "address": "10 Sampige Road",
      "phone": "91123456789",
      "state": "KA",
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized",
    "test": true,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com",
      "country": "IN",
      "city": "Bangalore",
      "zip": "560002",
      "address": "10 Sampige Road",
      "phone": "91123456789",
      "state": "KA"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "redirect-url",
      "method": "GET",
      "fields": []
    }
  }
}

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

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца и выбирает банк для проведения оплаты.
  2. Торговец отправляет запрос оплаты с методом оплаты bank_transfer_de, если страна банка покупателя – Германия или с методом bank_transfer_alt, если покупатель из другой страны EC. Торговец указывает ID выбранного банка, а также дополнительные параметры в зависимости от страны покупателя. Уточните список ID банков у вашего менеджера.
  3. PaySage.io присылает в ответе ссылку на QR код (для стран ЕС кроме Германии) и ссылку для оплаты.
  4. Продавец отображает покупателю QR код (для стран ЕС кроме Германии) и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код (для стран ЕС кроме Германии) или переходит по ссылке и совершает оплату.
  6. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  7. Торговец отображает покупателю статус оплаты.

Info

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

Оплата (для Германии)

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_de
Пример запроса 
{
  "request": {
    "amount": 2000,
    "currency": "EUR",
    "description": "description",
    "test": true,
    "return_url": "https://your_return_url.com",
    "method": {
      "type": "bank_transfer_de"
    }
  }
}
Ответ

Секция bank_transfer_de в ответе будет содержать параметр redirect_url, содержащий ссылку, которую следует отобразить покупателю.

Пример ответа 
{
  "transaction": {
    "uid": "3a824724-82a7-4123-b960-d1a2c437211d",
    "type": "payment",
    "status": "pending",
    "amount": 2000,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-03-10T20:17:27Z",
    "updated_at": "2024-03-10T20:17:27Z",
    "method_type": "bank_transfer_de",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/3a824724-82a7-4123-b960-d1a2c437211d/8143cc7527cb27ad7147d721b0f0224a7ff416aa484dd63d438ea4fc45b94c24",
    "payment": {
      "status": "pending",
      "gateway_id": 3797,
      "message": "Transaction was initialized."
    },
    "bank_transfer_de": {
      "type": "bank_transfer_de",
      "qr_code": null,
      "redirect_url": "https://redirect_url",
      "country": null,
      "id_number": null,
      "bic": null
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "test": true,
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}

Оплата (для стран ЕС кроме Германии)

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_alt
channel
обязательный
 string
ID банка, выбранного покупателем для оплаты. Уточните список ID банков у вашего менеджера.
id_number
условно обязательный
 string
IBAN для следующих стран: Австрия (AT), Бельгия (BE), Болгария (BG), Хорватия (HR), Кипр (CY), Чешская Республика (CZ), Дания (DK), Эстония (EE), Финляндия (FI), Греция (GR), Венгрия (HU), Италия (IT), Латвия (LV), Литва (LT), Люксембург (LU), Мальта (MT), Нидерланды (NL), Польша (PL), Румыния (RO), Словакия (SK), Словения (SI);

BBAN для Швеции (SE)

Параметр не требуется для Испании (ES), Франции (FR), Португалии (PT), Великобритании (UK) и Ирландии (IR).
bic
условно обязательный
 string
BIC банка покупателя (банковский идентификационный код).

Параметр обязателен для следующих стран: Австрия (AT), Бельгия (BE), Болгария (BG), Хорватия (HR), Кипр (CY), Чешская Республика (CZ), Дания (DK), Эстония (EE), Финляндия (FI), Греция (GR), Венгрия (HU), Италия (IT), Латвия (LV), Литва (LT), Люксембург (LU), Мальта (MT), Нидерланды (NL), Польша (PL), Румыния (RO), Словакия (SK), Словения (SI).
country
обязательный

 string (2)
Страна покупателя в формате ISO 3166-1 alpha-2. Например, AT.
условно обязательный
 object
Секция информации о покупателе. Секция обязательна для покупателей из следующих стран: Австрия (AT), Бельгия (BE), Болгария (BG), Хорватия (HR), Кипр (CY), Чешская Республика (CZ), Дания (DK), Эстония (EE), Финляндия (FI), Греция (GR), Венгрия (HU), Италия (IT), Латвия (LV), Литва (LT), Люксембург (LU), Мальта (MT), Нидерланды (NL), Польша (PL), Румыния (RO), Словакия (SK), Словения (SI) и Швеция (SE).
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
Пример запроса 
{
  "request": {
    "amount": 2000,
    "currency": "GBP",
    "description": "description",
    "test": true,
    "return_url": "https://your_return_url.com",
    "notification_url": "https://your_notification_url.com",
    "method": {
      "type": "bank_transfer_alt",
      "channel": "modelo-sandbox",
      "country": "GB"
    }
  }
}
Пример запроса для стран ЕС кроме ES, FR, PT, DE, GB и IE 
{
  "request": {
    "amount": 2000,
    "currency": "EUR",
    "description": "description",
    "test": true,
    "return_url": "https://your_return_url.com",
    "notification_url": "https://your_notification_url.com",
    "customer": {
      "first_name": "John",
      "last_name": "Doe"
    },
    "method": {
      "type": "bank_transfer_alt",
      "channel": "bank_id",
      "id_number": "NL91ABNA0417164300",
      "bic": "INGBNL2A",
      "country": "NL"
    }
  }
}
Ответ

Секция bank_transfer_alt в ответе будет содержать параметры qr_code и redirect_url, значения которых нужно отобразить покупателю.

Пример ответа 
{
  "transaction": {
    "uid": "8b598b5c-1ef0-4d3e-b5a9-9381caa9dc7e",
    "type": "payment",
    "status": "pending",
    "amount": 2000,
    "currency": "GBP",
    "description": "description",
    "created_at": "2024-02-23T13:43:08Z",
    "updated_at": "2024-02-23T13:43:09Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/8b598b5c-1ef0-4d3e-b5a9-9381caa9dc7e/4dbcae1c56ec5529d0a4b8a6b2c7187bc642ab8fd276ed95f9e741a60b45bace",
    "payment": {
      "status": "pending",
      "gateway_id": 3762,
      "ref_id": "ff2d41c6-1da3-4dc2-a70a-ed427da28054",
      "message": "Transaction was initialized."
    },
    "bank_transfer_alt": {
      "type": "bank_transfer_alt",
      "qr_code": "https://images.yp.com/image/458bb8ed-123c-4e40-ba6d-48c295049ffb/1708695789?size=0",
      "redirect_url": "https://payment-link.com",
      "country": "GB"
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "test": true,
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}

Оплата с помощью Revolut

  1. Покупатель выбирает опцию оплаты через Revolut на сайте торговца.
  2. Торговец отправляет в PaySage.io запрос оплаты, указав bank_transfer_revolut в качестве method.type.
  3. PaySage.io присылает в ответе ссылку на QR код и ссылку для оплаты.
  4. Продавец отображает покупателю QR код и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код или переходит по ссылке, авторизуется на сайте или в приложении Revolut и совершает оплату.
  6. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  7. Торговец отображает покупателю статус оплаты.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_revolut
country
обязательный

 string (2)
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
Пример запроса 
{
    "request": {
        "amount": 2000,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://your_return_url.com",
        "notification_url": "https://your_notification_url.com",
        "method": {
            "type": "bank_transfer_revolut",
            "country": "PL"
        }
    }
}
Ответ

Секция bank_transfer_revolut в ответе будет содержать параметры qr_code и redirect_url, значения которых нужно отобразить покупателю.

Пример ответа 
{
  "transaction": {
    "uid": "90ca56dc-cea2-461c-ac0d-fd02da341de3",
    "type": "payment",
    "status": "pending",
    "amount": 2000,
    "currency": "EUR",
    "description": "TEST",
    "created_at": "2024-10-11T09:25:00Z",
    "updated_at": "2024-10-11T09:25:00Z",
    "method_type": "bank_transfer_revolut",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/90ca56dc-cea2-461c-ac0d-fd02da341de3/371904f3a972b724d538df0202df4066bc7336dc4bf40c1df12039ec625f375e?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3853,
      "ref_id": "ref_id-2323265351",
      "message": "Transaction was initialized."
    },
    "bank_transfer_revolut": {
      "type": "bank_transfer_revolut",
      "qr_code": "https://yp/image/dc6cee8d-418c-4b79-a51e-aca8f762be62/1703157089?size=0",
      "redirect_url": "payment-url",
      "country": "PL",
      "reference": "1728638700701564",
      "name": ""
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": true,
    "language": "en",
    "billing_address": {},
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}

Оплата с помощью Wise

  1. Покупатель выбирает опцию оплаты через Wise на сайте торговца.
  2. Торговец отправляет в PaySage.io запрос оплаты, указав bank_transfer_wise в качестве method.type.
  3. PaySage.io присылает в ответе ссылку на QR код и ссылку для оплаты.
  4. Продавец отображает покупателю QR код и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код или переходит по ссылке, авторизуется в приложении или на сайте Wise и совершает оплату.
  6. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  7. Торговец отображает покупателю статус оплаты.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_wise
Пример запроса 
{
    "request": {
        "amount": 2000,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://your_return_url.com",
        "notification_url": "https://your_notification_url.com",
        "method": {
            "type": "bank_transfer_wise"                
        }
    }
}
Ответ

Секция bank_transfer_wise в ответе будет содержать параметры qr_code и redirect_url, значения которых нужно отобразить покупателю.

Пример ответа 
{
  "transaction": {
    "uid": "42fc4210-ccb1-4b60-8035-77d329b90abb",
    "type": "payment",
    "status": "pending",
    "amount": 20400,
    "currency": "EUR",
    "description": "TEST",
    "created_at": "2024-10-11T09:26:02Z",
    "updated_at": "2024-10-11T09:26:02Z",
    "method_type": "bank_transfer_wise",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/42fc4210-ccb1-4b60-8035-77d329b90abb/c181f7c0657bf4982a7e8673683a7ceb398663d5be4ef7fb8c25bb59c620a3ca?language=tg",
    "payment": {
      "status": "pending",
      "gateway_id": 3853,
      "ref_id": "ref_id-8361483988",
      "message": "Transaction was initialized."
    },
    "bank_transfer_wise": {
      "type": "bank_transfer_wise",
      "qr_code": "https://yp/image/dc6cee8d-418c-4b79-a51e-aca8f762be62/1703157089?size=0",
      "redirect_url": "payment_url",
      "reference": "1728638762497314",
      "name": ""
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": false,
    "language": "tg",
    "billing_address": {},
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    }
  }
}

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

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaySage.io.
  5. Покупатель совершает платеж на странице оплаты в течение отведенного времени. Время, за которое требуется совершить оплату, указывается в настройках магазина администратором PaySage.io. По умолчанию, 60 минут.
  6. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.
  7. Если покупатель не завершает оплату в указанный период, то по истечении предоставленного для оплаты времени торговец может получить автоматическое уведомление со статусом expired. Если оплата будет произведена после предоставленного для оплаты интервала, то торговцу высылается повторное уведомление с обновленным статусом.

Info

Этот вариант интеграции поддерживает валюты BGN, CHF, CZK, DKK, EUR, GBP, SEK, HUF, PLN, RON, HRK, USD и JPY.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
object
Секция информации о покупателе.
first_name
обязательный

 string
Имя покупателя.
last_name
обязательный

 string
Фамилия покупателя.
middle_name
 string
Отчество покупателя.
country
обязательный

 string (2)
Страна покупателя в формате ISO 3166-1 alpha-2. Например, PL.
state
 string
Штат покупателя.
city
 string
Город покупателя.
zip
обязательный

 string
Почтовый индекс покупателя.
address
 string
Адрес покупателя.
phone
 string (32)
Номер телефона покупателя.
email
обязательный

 string
Адрес электронной почты покупателя.
Пример запроса 
{
  "request": {
    "amount": 20000,
    "currency": "EUR",
    "description": "test",
    "test": true,
    "tracking_id": "your_uniq_number",
    "language": "en",
    "notification_url": "https://webhook-url.com",
    "return_url": "https://example.com",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example2@example.com",
      "country": "PL",
      "zip":"00-120"
    },
    "method": {
      "type": "bank_transfer"
    }
  }
}
Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form. Для завершения платежа направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа 
{
  "transaction": {
    "uid": "9005b9da-5330-4af8-bc99-18275a431dbb",
    "type": "payment",
    "status": "pending",
    "amount": 20000,
    "currency": "EUR",
    "description": "test",
    "created_at": "2024-04-01T14:09:24Z",
    "updated_at": "2024-04-01T14:09:25Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/9005b9da-5330-4af8-bc99-18275a431dbb/febfce9db414c382044cb940bf278b0acdca04db3e993ad86a4a3ebe167a44ff?language=en",
    "payment": {
      "status": "pending",
      "gateway_id": 3870,
      "ref_id": "a457ca54-fa27-4671-89f6-8f76aa27f826",
      "message": "Transaction was initialized."
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example2@example.com",
      "country": "PL",
      "zip": "00-120",
      "ip": null
    },
    "manually_corrected_at": null,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": true,
    "language": "en",
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "email": "example2@example.com"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "https://payments.vp.eu/p/a457ca54-fa27-4671-89f6-8f76aa27f826/",
      "method": "GET",
      "fields": []
    }
  }
}

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

Процесс проведения оплаты

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в PaySage.io.
  3. PaySage.io присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Продавец перенаправляет покупателя на страницу из параметра form.action из ответа PaySage.io.
  5. Страница отображает список банков, доступных для страны, указанной в method.channel. Покупатель выбирает банк, приложение которого он будет использовать для оплаты, и завершает транзакцию.
  6. PaySage.io отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у PaySage.io с помощью запроса получения статуса транзакции.

Info

Этот вариант интеграции поддерживает валюты EUR и GBP.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
channel
обязательный
 string
Страна банка, приложение которого покупатель будет использовать, в формате ISO 3166-1 alpha-2. Возможные значения: AT (Австрия), BE (Бельгия), EE (Эстония), FI (Финляндия), FR (Франция), DE (Германия), GB (Великобритания), IE (Ирландия), IT (Италия), NL (Нидерланды), NO (Норвегия), PT (Португалия), ES (Испания), SE (Швеция).
object
Секция информации о покупателе.
external_id
обязательный

 string
Идентификатор покупателя в системе торговца.
Пример запроса 
{
    "request": {
        "amount": 200,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://your_return_url.com",
        "notification_url": "https://your_notification_url.com",
        "method": {
            "type": "bank_transfer",
            "channel": "FR"
        },
        "customer": {
            "external_id": "test-test"
        }
    }
}
Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form. Для завершения платежа направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа 
{
  "transaction": {
    "uid": "27e52cfa-295b-43cf-8201-01d0a777320f",
    "type": "payment",
    "status": "pending",
    "amount": 200,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-11-20T15:53:30Z",
    "updated_at": "2024-11-20T15:53:30Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/27e52cfa-295b-43cf-8201-01d0a777320f/74b62c2278e3b29f70f5db7f5c3949e4d7a266bd652e5ff9a9abdb9841b3c53a",
    "payment": {
      "status": "pending",
      "gateway_id": 4644,
      "ref_id": "5e747509-4b2e-8a0a-03ea-5697eb",
      "message": "Transaction was initialized."
    },
    "bank_transfer": {
      "type": "bank_transfer",
      "channel": "FR"
    },
    "customer": {
      "external_id": "test-test",
      "email": null,
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "external_id": "test-test"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://test-ys/hosted?transaction-id=5e747509-4b2e-8a0a-03ea-5697eb",
      "method": "GET",
      "fields": []
    }
  }
}

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующими данными:
object
ip
обязательный

 string
IP-адрес покупателя.
object
Секция параметров способа выплаты.
type
обязательный
 string
bank_transfer
account
обязательный
 string
Идентификатор счета покупателя, на который будет осуществляться выплата. Используйте значение customer.account из последнего автоматического уведомления по успешной транзакции оплаты.
object
Секция информации о покупателе.
external_id
обязательный

 string
Уникальный идентификатор покупателя в системе торговца. Для одного покупателя должен всегда использоваться один и тот же external_id. Выплата может быть осуществлена только в случае, если в системе уже была оплата по соответствующему customer.external_id.
email
обязательный

 string
Адрес электронной почты покупателя.
device_id
обязательный

 string
Операционная система устройства покупателя.
Пример запроса 
{
    "request": {
        "amount": 2200,
        "currency": "EUR",
        "description": "test",
        "test": false,
        "tracking_id": "your_uniq_number21212",
        "ip": "174.100.64.133",        
        "customer": {                       
            "email": "john.doe@example.com",            
            "external_id": "test-test",
            "device_id": "iOS 14"
        },
        "method": {
            "type": "bank_transfer",            
            "account": "13c7f5b1-b696-4be7-b8ac-3ee247aab6c0"

        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "c69d4100-a09e-4e1c-b63c-5b1f257ec066",
        "type": "payout",
        "status": "successful",
        "amount": 2200,
        "currency": "EUR",
        "description": "test",
        "created_at": "2024-11-22T07:44:40Z",
        "updated_at": "2024-11-22T07:44:42Z",
        "manually_corrected_at": null,
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/c69d4100-a09e-4e1c-b63c-5b1f257ec066/c8372f29d97cb9816d95ed91d6e8d87b96d60bb7f04ecccc5324d05a3ae4b004",
        "payout": {
            "status": "successful",
            "gateway_id": 4629,
            "ref_id": "XRUXuAfgDs8GvhDFd0",
            "message": "Transaction was successfully processed."
        },
        "bank_transfer": {
            "type": "bank_transfer",
            "account": "SMwnzzU7mVbhO/eczsaDKDMTqo7/pjP+fL0gUEfAR+4ZG5gsMW0=",
            "bank_name": "CITIZEN_TEST_BANK",
            "bank_code": "E6/qeB6O8Y50UE3JjnqiBA==",
            "account_name": "CitizenTestAccount Holder"
        },
        "customer": {
            "email": "john.doe@example.com",
            "ip": "174.100.64.133"
        },
        "version": 0,
        "message": "Transaction was successfully processed.",
        "tracking_id": "your_uniq_number21212",
        "test": false,
        "paid_at": "2024-11-22T07:44:42+00:00",
        "billing_address": {
            "email": "john.doe@example.com",
            "device_id": "iOS 14",
            "external_id": "test-test"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }        
    }
}

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

Info

Запрос оплаты для этого варианта интеграции поддерживает следующие валюты: DKK для bank_transfer_denmark, EUR для bank_transfer_estonia и bank_transfer_finland, и SEK для bank_transfer_sweden.

Info

Запрос выплаты для этого варианта интеграции поддерживает только валюту EUR.

Процесс проведения оплаты

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

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
currency
обязательный
 string
DKK для bank_transfer_denmark, EUR для bank_transfer_estonia и bank_transfer_finland, и SEK для bank_transfer_sweden.
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_denmark для платежей в банках Дании, bank_transfer_estonia для Эстонии, bank_transfer_finland для Финляндии, bank_transfer_sweden для Швеции.
account
обязательный
 string
BIC номер банка, используемого для оплаты.
account_name
 string
Дополнительная информация о покупателе.
object
Секция информации о покупателе.
email
обязательный
 string
Email покупателя.
phone
обязательный
 string
Номер телефона покупателя со знаком +.
external_id
 string
Уникальный идентификатор покупателя в системе торговца.
taxpayer_id
 string
Персональный идентификационный номер (Швеция) или личный идентификационный номер (Финляндия).
Номера BIC

Дания

Банк BIC
Danskebank DABADKKK
Jyskebank JYBADKKK
Nykredit NYKBDKKK
Sydbank SYBKDK22
Nordea NDEADKKK
Arbejdernes Landsbank ALBADKKK

Эстония

Банк BIC
SEB EEUHEE2X
Swedbank/Sparbankerna HABAEE2X
LHV LHVBEE22
Luminor RIKOEE22

Швеция

Банк BIC
Nordea NDEASESS
Swedbank/Sparbankerna SWEDSESS
Handelsbanken HANDSESS
SEB ESSESESS
Länsförsäkringar ELLFSESS
Danske Bank DABASESX
ICA IBCASES1
Skandiabanken SKIASESS

Финляндия

Банк BIC
OP Bank OKOYFIHH
Nordea NDEAFIHH
Danske Bank DABAFIHH
Aktia HELSFIHH
Alandsbanken AABAFI22
POP Pankki POPFFI22
S-Pankki SBANFIHH
Handelsbanken HANDFIHH
Säästöpankki ITELFIHH
OMA säästöpankki OMSAFI2S
Пример запроса 
{
    "request": {
        "amount": 7077,
        "currency": "EUR",
        "description": "test",
        "test": false,
        "tracking_id": "your_uniq_number21212",
        "return_url": "https://your-success.url",
        "method": {
            "type": "bank_transfer_finland",
            "account": "OKOYFIHH"
        },
        "customer": {
          "email": "example@example.com",
          "phone": "+358401234567"
        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "96cce92c-980f-4016-8058-a891916143c3",
        "type": "payment",
        "status": "pending",
        "amount": 7077,
        "currency": "EUR",
        "description": "test",
        "created_at": "2024-12-03T14:55:20Z",
        "updated_at": "2024-12-03T14:55:20Z",
        "method_type": "bank_transfer_finland",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/96cce92c-980f-4016-8058-a891916143c3/b63e54e13ff814695896fc0e395ca60f55416c13e54e5edbfdf02ef3b38ed233",
        "payment": {
            "status": "pending",
            "gateway_id": 4677,
            "ref_id": "981856a8a6625d660f59",
            "message": "Transaction was initialized."
        },
        "bank_transfer_finland": {
            "type": "bank_transfer_finland"
        },
        "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": "https://zr/v4/fi/deposits?s=981856a8a6625d660f59",
            "method": "GET",
            "fields": []
        }
    }
}

Выплата средств для Эстонии или Финляндии

Запрос

Отправьте запрос выплаты средств со следующими данными:
object
currency
обязательный
 string
EUR.
ip
обязательный
 string
IP-адрес покупателя.
object
Секция параметров способа выплаты.
type
обязательный
 string
bank_transfer_finland или bank_transfer_estonia
account
 string
IBAN для выплаты.
object
Секция информации о покупателе.
email
обязательный
 string
Адрес электронной почты покупателя.
phone
обязательный
 string
Номер телефона покупателя.
taxpayer_id
условно обязательный
 string
Личный идентификационный номер (Финляндия). Обязателен, если не отправляется customer.external_id.
external_id
условно обязательный
 string
Уникальный идентификатор покупателя в системе торговца. Выплата может быть осуществлена только в случае, если в системе уже была оплата по соответствующему customer.external_id. Значение customer.external_id можно узнать в личном кабинете провайдера или в автоматическом уведомлении по транзакции оплаты. Обязателен, если не отправляется customer.taxpayer_id.
Пример запроса 
{
    "request": {
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "test": true,        
        "ip": "87.92.128.2",
        "method": {
            "type": "bank_transfer_finland"
        },
        "customer": {
            "taxpayer_id": "010200A9618",
            "email": "example@example.com",
            "phone": "+358401234567"
        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "9d1beb60-5161-40ff-95d3-ebff1576bc79",
        "type": "payout",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "created_at": "2024-12-03T16:38:27Z",
        "updated_at": "2024-12-03T16:38:28Z",
        "manually_corrected_at": null,
        "method_type": "bank_transfer_finland",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/9d1beb60-5161-40ff-95d3-ebff1576bc79/163a7ee19a7b7b44f162c9f87395c5489b110219a336a5d6596b534fa07e7149",
        "payout": {
            "status": "pending",
            "gateway_id": 4677,
            "ref_id": "81905ffa-da9b-49de-a8cf-23593561c2dc",
            "message": "Transaction was initialized."
        },
        "bank_transfer_finland": {
            "type": "bank_transfer_finland"
        },
        "customer": {
            "email": null,
            "ip": "87.92.128.2"
        },
        "version": 0,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "taxpayer_id": "010200A9618"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }       
    }
}

Выплата средств для стран, кроме Эстонии или Финляндии

Запрос

Отправьте запрос выплаты средств со следующими данными:
object
currency
обязательный
 string
EUR.
ip
обязательный

 string
IP-адрес покупателя.
object
Секция параметров способа выплаты.
type
обязательный
 string
bank_transfer
account
обязательный
 string
IBAN для выплаты.
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
birth_date
обязательный
 string
Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD
country
обязательный

 string
Страна покупателя. Допустимые значения: AT (Австрия), BE (Бельгия), HR (Хорватия), CY (Кипр), FR (Франция), GR (Греция), IE (Ирландия), IT (Италия), LV (Латвия), LT (Литва), LU (Люксембург), MT (Мальта), PL (Польша), PT (Португалия), SK (Словакия), SI (Словения), ES (Испания), CH (Швейцария), GB (Великобритания), DE (Германия), NL (Нидерланды).
taxpayer_id
 string
Национальный идентификационный номер покупателя.
email
 string
Адрес электронной почты покупателя.
phone
 string
Номер телефона покупателя.
Пример запроса 
{
    "request": {
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://your-success.url",
        "ip": "85.214.132.117",
        "method": {
            "type": "bank_transfer",
            "account": "DE89370400440532013000"
        },
        "customer": {
            "first_name": "Wolfgang",
            "last_name": "Olsen",
            "country": "DE",
            "birth_date": "1980-12-12"
        }
    }
}
Ответ
Пример ответа 
{
  "transaction": {
    "uid": "10638b6b-042a-45e6-a7b1-8679ffc244f1",
    "type": "payout",
    "status": "pending",
    "amount": 100,
    "currency": "EUR",
    "description": "description",
    "created_at": "2024-12-03T17:04:06Z",
    "updated_at": "2024-12-03T17:04:06Z",
    "manually_corrected_at": null,
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/10638b6b-042a-45e6-a7b1-8679ffc244f1/2dd991850812af363f5441cc43f48f3fbd230a9d74aad781ce2df70623e19911",
    "payout": {
      "status": "pending",
      "gateway_id": 4677,
      "ref_id": "7fa93716-d797-4c12-b7e9-17128f9923f6",
      "message": "Transaction was initialized."
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "email": null,
      "ip": "85.214.132.117"
    },
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "Wolfgang",
      "last_name": "Olsen",
      "country": "DE",
      "birth_date": "1980-12-12"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}

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

Процесс проведения оплаты

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

Info

Этот вариант интеграции поддерживает валюты EUR, GBP и PLN.

Оплата

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
bank_name
 string
Название банка, используемого для перевода. Возможные значения: revolut, wise.
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
email
обязательный

 string
Адрес электронной почты покупателя.
country
обязательный

 string
Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AT (Австрия), BE (Бельгия), EE (Эстония), FI (Финляндия), FR (Франция), DE (Германия), IE (Ирландия), IT (Италия), LV (Латвия), NL (Нидерланды), PT (Португалия), ES (Испания).
address
 string
Адрес покупателя.
city
 string
Город покупателя.
state
 string
Штат покупателя.
zip
 string
Почтовый индекс покупателя.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 138,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "bank_transfer",
            "bank_name": "wise"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "country": "ES",
            "email": "john.willson@example.com"
        }
    }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "695ee9a8-ede6-430c-a1df-9775022e614d",
    "type": "payment",
    "status": "pending",
    "amount": 138,
    "currency": "EUR",
    "description": "description",
    "created_at": "2025-02-10T07:07:12Z",
    "updated_at": "2025-02-10T07:07:27Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/695ee9a8-ede6-430c-a1df-9775022e614d/cd1bf37ef66b29ef0e0a3220527162ba3f1a4b38ddc88da8d8a5f9f237d9812e",
    "payment": {
      "status": "pending",
      "gateway_id": 4869,
      "ref_id": "100563156",
      "message": "Transaction was initialized.",
      "bank_code": "",
      "rrn": ""
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "john.willson@example.com",
      "country": "ES",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "john.willson@example.com",
      "country": "ES"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },   
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "https://ma.tech/df69782abc691a514d3efaba812e292a",
      "method": "GET",
      "fields": []
    }
  }
}

Оплата (для Германии)

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_de
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
email
обязательный

 string
Адрес электронной почты покупателя.
country
 string
Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: DE (Германия).
address
 string
Адрес покупателя.
city
 string
Город покупателя.
state
 string
Штат покупателя.
zip
 string
Почтовый индекс покупателя.
Пример запроса 
{
  "request": {
    "test": true,
    "amount": 10,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://return.com",
    "method": {
      "type": "bank_transfer_de"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "email": "john.willson@example.com"
    }
  }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "67d980bf-3464-4beb-b98a-386a6e80911b",
    "type": "payment",
    "status": "pending",
    "amount": 10,
    "currency": "EUR",
    "description": "description",
    "created_at": "2025-07-22T08:09:23Z",
    "updated_at": "2025-07-22T08:09:24Z",
    "method_type": "bank_transfer_de",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/67d980bf-3464-4beb-b98a-386a6e80911b/05f5e956524df29ff543e9de484df3e255308a677c5efed8b050026046fe41e4",
    "payment": {
      "status": "pending",
      "gateway_id": 5603,
      "ref_id": "240137",
      "message": "Transaction was initialized.",
      "bank_code": "",
      "rrn": ""
    },
    "bank_transfer_de": {
      "type": "bank_transfer_de"
    },
    "customer": {
      "email": "john.willson@example.com",
      "last_name": "Willson",
      "first_name": "John",
      "ip": null
    },
    "manually_corrected_at": null,
    "version": 1,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "email": "john.willson@example.com",
      "last_name": "Willson",
      "first_name": "John"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    },
    "gateway": {
      "iframe": true
    },
    "form": {
      "action": "payment-page",
      "method": "GET",
      "fields": []
    }
  }
}

Оплата с помощью Revolut

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_revolut
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
email
обязательный

 string
Адрес электронной почты покупателя.
country
обязательный

 string
Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AT (Австрия), BE (Бельгия), BG (Болгария), CY (Кипр), CZ (Чехия), DE (Германия), DK (Дания), EE (Эстония), FI (Финляндия), FR (Франция), ES (Испания), GR (Греция), HU (Венгрия), HR (Хорватия), IS (Исландия), IE (Ирландия), IT (Италия), LI (Лихтенштейн), LT (Литва), LU (Люксембург), LV (Латвия), MT (Мальта), NL (Нидерланды), NO (Норвегия), PT (Португалия), RO (Румыния), SE (Швеция), SI (Словения), SK (Словакия).
address
 string
Адрес покупателя.
city
 string
Город покупателя.
state
 string
Штат покупателя.
zip
 string
Почтовый индекс покупателя.
Пример запроса 
{
  "request": {
    "test": true,
    "amount": 11,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://return.com",
    "method": {
      "type": "bank_transfer_revolut"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "country": "BE",
      "email": "john.willson@example.com"
    }
  }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "2072b6d7-35da-4dd7-9ae9-3de7abc55a3c",
        "type": "payment",
        "status": "pending",
        "amount": 11,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-07-22T11:21:25Z",
        "updated_at": "2025-07-22T11:21:25Z",
        "method_type": "bank_transfer_revolut",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/2072b6d7-35da-4dd7-9ae9-3de7abc55a3c/761729ae10fd87dac1241635382c967d622a998f8383a6f8208f65b582fc21b4",
        "payment": {
            "status": "pending",
            "gateway_id": 5603,
            "ref_id": "240367",
            "message": "Transaction was initialized.",
            "bank_code": "",
            "rrn": ""
        },
        "bank_transfer_revolut": {
            "type": "bank_transfer_revolut"
        },
        "customer": {
            "email": "john.willson@example.com",
            "country": "BE",
            "last_name": "Willson",
            "first_name": "John",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "email": "john.willson@example.com",
            "country": "BE",
            "last_name": "Willson",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "payment_page",
            "method": "GET",
            "fields": []
        }
    }
}

Оплата с помощью Wise

Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer_wise
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
email
обязательный

 string
Адрес электронной почты покупателя.
country
обязательный

 string
Страна банка покупателя в формате ISO 3166-1 alpha-2. Возможные значения: AE (Объединённые Арабские Эмираты), CH (Швейцария), DE (Германия), ES (Испания), GB (Великобритания), HK (Гонконг), HU (Венгрия), ID (Индонезия), IE (Ирландия), IN (Индия), IT (Италия), JP (Япония), NL (Нидерланды), NZ (Новая Зеландия), PL (Польша), PT (Португалия), RO (Румыния), SG (Сингапур), US (Соединённые Штаты).
address
 string
Адрес покупателя.
city
 string
Город покупателя.
state
 string
Штат покупателя.
zip
 string
Почтовый индекс покупателя.
Пример запроса 
{
  "request": {
    "test": true,
    "amount": 11,
    "currency": "EUR",
    "description": "description",
    "return_url": "https://return.com",
    "method": {
      "type": "bank_transfer_wise"
    },
    "customer": {
      "first_name": "John",
      "last_name": "Willson",
      "country": "AE",
      "email": "john.willson@example.com"
    }
  }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "cfa9e31c-8ef9-4a64-abbf-d14f5afd6ff0",
        "type": "payment",
        "status": "pending",
        "amount": 11,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-07-22T12:33:12Z",
        "updated_at": "2025-07-22T12:33:12Z",
        "method_type": "bank_transfer_wise",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/cfa9e31c-8ef9-4a64-abbf-d14f5afd6ff0/f31acda6fe32b797351f7273c63a7fa3d6c0255e8c71aeadc38ba25631f23f68",
        "payment": {
            "status": "pending",
            "gateway_id": 5603,
            "ref_id": "240369",
            "message": "Transaction was initialized.",
            "bank_code": "",
            "rrn": ""
        },
        "bank_transfer_wise": {
            "type": "bank_transfer_wise"
        },
        "customer": {
            "email": "john.willson@example.com",
            "country": "AE",
            "last_name": "Willson",
            "first_name": "John",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "email": "john.willson@example.com",
            "country": "AE",
            "last_name": "Willson",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },        
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "payment_page",
            "method": "GET",
            "fields": []
        }
    }
}

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

Оплата

Info

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

Процесс проведения оплаты

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

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
ip
 string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
object
Секция информации о покупателе.
email
обязательный

 string
Адрес электронной почты покупателя.
object
browser
 object
Секция параметров браузера покупателя.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://return.com",
        "ip": "193.128.0.1",
        "method": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": "john.willson@example.com"
        },
        "additional_data": {
            "browser": {
                "screen_width": 1920,
                "screen_height": 1080,
                "screen_color_depth": 24,
                "language": "en",
                "java_enabled": false,
                "user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0",
                "time_zone": -180,
                "time_zone_name": "Europe/Berlin",
                "window_height": 726,
                "window_width": 600,
                "accept_header": "application/json"
            }
        }
    }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "cccbee04-a6a1-4e6c-aa95-7a118402a851",
    "type": "payment",
    "status": "pending",
    "amount": 500,
    "currency": "EUR",
    "description": "description",
    "created_at": "2025-02-13T07:29:54Z",
    "updated_at": "2025-02-13T07:29:54Z",
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/cccbee04-a6a1-4e6c-aa95-7a118402a851/9ac468d33bdae6720e96d2f9f1f248d4964759d0154695b9cf85c5d46e8c9fa6",
    "payment": {
      "status": "pending",
      "gateway_id": 4974,
      "ref_id": "155481930",
      "message": "Transaction was initialized.",
      "bank_code": 0
    },
    "bank_transfer": {
      "type": "bank_transfer"
    },
    "customer": {
      "email": "john.willson@example.com",
      "ip": "193.128.0.1"
    },
    "manually_corrected_at": null,
    "version": 0,
    "message": "Transaction was initialized.",
    "test": true,
    "billing_address": {
      "email": "john.willson@example.com"
    },
    "additional_data": {
      "browser": {
        "user_agent": "Mozilla/5.0 (X11; Ubuntu; Linux x86_64; rv:96.0) Gecko/20100101 Firefox/96.0",
        "screen_width": 1920,
        "screen_height": 1080,
        "screen_color_depth": 24,
        "language": "en",
        "java_enabled": false,
        "time_zone": -180,
        "time_zone_name": "Europe/Berlin",
        "window_height": 726,
        "window_width": 600,
        "accept_header": "application/json"
      },
      "payment_method": {
        "type": "alternative"
      }
    },    
    "gateway": {
      "iframe": false
    },
    "form": {
      "action": "er-payment-page/en/v2-d9d796cb-aa25-47af-b4c6-3e74dffd2402?formID=1",
      "method": "POST",
      "fields": []
    }
  }
}

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

Выплата

Info

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

Процесс проведения выплаты

  1. Торговец отправляет запрос выплаты в PaySage.io, указав идентификатор счета получателя выплаты.
  2. PaySage.io присылает ответ со статусом pending/failed/error/.
  3. PaySage.io отправляет торговцу автоматическое уведомление с финальным статусом выплаты. Торговец также может запросить статус выплаты у PaySage.io с помощью запроса получения статуса транзакции.
Запрос

Отправьте запрос оплаты со следующими данными:
object
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
account_number
обязательный
 string
IBAN счета получателя выплаты или идентификатор счета получателя выплаты в системе торговца.
object
Секция информации о получателе выплаты.
first_name
обязательный
 string
Имя получателя выплаты.
last_name
обязательный
 string
Фамилия получателя выплаты.
address
 string (510)
Адрес получателя выплаты.
country
 string
Страна получателя выплаты в формате ISO 3166-1 alpha-2.
taxpayer_id
 string
Идентификационный номер налогоплательщика, присвоенный получателю выплаты.
Пример запроса 
{
    "request": {
        "amount": 110,
        "currency": "EUR",
        "description": "description",
        "test": false,
        "tracking_id": "your_uniq_number",      
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "US",
            "taxpayer_id": "12312312321fff67"
        },
        "method": {
            "type": "bank_transfer",
            "account": "LT742140072746012441"
        }
    }
}
Ответ
Пример ответа 
{
  "transaction": {
    "uid": "58d11429-5550-4f06-8452-f0a803676b98",
    "type": "payout",
    "status": "pending",
    "amount": 110,
    "currency": "EUR",
    "description": "description",
    "created_at": "2025-03-27T10:35:57Z",
    "updated_at": "2025-03-27T10:36:00Z",
    "manually_corrected_at": null,
    "method_type": "bank_transfer",
    "receipt_url": "https://backoffice.paysage.io/customer/transactions/58d11429-5550-4f06-8452-f0a803676b98/dba17b315cfe8265c74557fc5a789bc4ef1a2c60c2db725deb248201f706cc6d",
    "payout": {
      "status": "pending",
      "gateway_id": 5175,
      "ref_id": "P20250327-RM827J",
      "message": "Transaction was initialized."
    },
    "bank_transfer": {
      "type": "bank_transfer",
      "account": "LT742140072746012441"
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "version": 0,
    "message": "Transaction was initialized.",
    "tracking_id": "your_uniq_number",
    "test": false,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "US",
      "taxpayer_id": "12312312321fff67"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}

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

Оплата

Info

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

Процесс проведения оплаты

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

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращен покупатель после завершения оплаты.
ip
 string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
object
Секция информации о покупателе.
email
обязательный
 string
Адрес электронной почты покупателя.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 100,
        "currency": "EUR",
        "ip": "127.0.0.1",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "bank_transfer"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Willson",
            "email": "john.willson@example.com"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "1975e85b-a63d-497d-8d96-1d92f356ac13",
        "type": "payment",
        "status": "pending",
        "amount": 100,
        "currency": "EUR",
        "description": "description",
        "created_at": "2025-06-18T19:04:54Z",
        "updated_at": "2025-06-18T19:04:56Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.paysage.io/customer/transactions/1975e85b-a63d-497d-8d96-1d92f356ac13/d47437c5c638219f1f0fe56b5fa303d3379c0eee6205d8f3bce27fc32244c92a",
        "payment": {
            "status": "pending",
            "gateway_id": 5508,
            "ref_id": "666c5304-6c8e-414f-a401-cfdcdc8b1c14",
            "message": "Transaction was initialized."
        },
        "bank_transfer": {
            "type": "bank_transfer"
        },
        "customer": {
            "email": "john.willson@example.com",
            "last_name": "Willson",
            "first_name": "John",
            "ip": "127.0.0.1"
        },
        "manually_corrected_at": null,
        "version": 2,
        "message": "Transaction was initialized.",
        "code": "P.9999",
        "friendly_message": ".",
        "test": true,
        "billing_address": {
            "email": "john.willson@example.com",
            "last_name": "Willson",
            "first_name": "John"
        },
        "additional_data": {
            "short_uid": "175027349469858906",
            "payment_method": {
                "type": "alternative"
            }
        },        
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "method": "GET",
            "fields": []
        }
    }
}