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

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

Вариант интеграции 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. Торговец отображает покупателю статус оплаты.

Оплата

Запрос

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

Параметр Тип данных Описание
request 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, на который будет возвращен покупатель после завершения операции в платёжной системе.
method 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.

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

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

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

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method 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
    }
  }
}

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

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method 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.
customer * условно обязательный 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. Торговец отображает покупателю статус оплаты.
Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method 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. Торговец отображает покупателю статус оплаты.
Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method 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.

Оплата

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
customer * обязательный 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 (510) 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.

Оплата

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method 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 (Швеция).
customer * обязательный 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": []
    }
  }
}

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

Запрос

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

Параметр Тип данных Описание
request object
ip * обязательный
 string IP-адрес покупателя.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
account
* обязательный		 string Идентификатор счета покупателя, на который будет осуществляться выплата. Используйте значение customer.account из последнего автоматического уведомления по успешной транзакции оплаты.
customer * обязательный 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 с помощью запроса получения статуса транзакции.

Оплата

Запрос

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

Параметр Тип Описание
request object
currency
* обязательный		 string DKK для bank_transfer_denmark, EUR для bank_transfer_estonia и bank_transfer_finland, и SEK для bank_transfer_sweden.
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer_denmark для платежей в банках Дании, bank_transfer_estonia для Эстонии, bank_transfer_finland для Финляндии, bank_transfer_sweden для Швеции.
account
* обязательный		 string BIC номер банка, используемого для оплаты.
account_name string Дополнительная информация о покупателе.
customer 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": []
        }
    }
}

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

Запрос

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

Параметр Тип данных Описание
request object
currency* обязательный
 string EUR.
ip * обязательный
 string IP-адрес покупателя.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer_finland или bank_transfer_estonia
account string IBAN для выплаты.
customer 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"
            }
        }       
    }
}

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

Запрос

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

Параметр Тип данных Описание
request object
currency* обязательный
 string EUR.
ip * обязательный
 string IP-адрес покупателя.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
account
* обязательный		 string IBAN для выплаты.
customer 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.

Оплата

Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
customer 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 (Испания).
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 138,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "bank_transfer"
        },
        "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": []
    }
  }
}

Вариант интеграции 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 с помощью запроса получения статуса транзакции.
Запрос

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

Параметр Тип Описание
request object
return_url
* обязательный		 string URL, на который будет возвращен покупатель после завершения оплаты.
ip string IP-адрес покупателя.
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
customer object Секция информации о покупателе.
email * обязательный
 string Адрес электронной почты покупателя.
additional_data 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": "GET",
      "fields": []
    }
  }
}

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

Выплата

Info

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

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

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

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

Параметр Тип Описание
request object
method object Секция параметров способа оплаты.
type
* обязательный		 string bank_transfer
account_number
* required
 string IBAN счета получателя выплаты или идентификатор счета получателя выплаты в системе торговца.
customer 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"
      }
    }
  }
}