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

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

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

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

  1. Покупатель инициирует оплату на сайте торговца и выбирает банк для проведения оплаты.
  2. Торговец отправляет запрос оплаты с методом оплаты bank_transfer_de, если страна банка покупателя – Германия или с методом bank_transfer_alt, если покупатель из другой страны EC. Торговец указывает ID выбранного банка, а также дополнительные параметры в зависимости от страны покупателя. Уточните список ID банков у вашего менеджера.
  3. Demo PSP присылает в ответе ссылку на QR код (для стран ЕС кроме Германии) и ссылку для оплаты.
  4. Продавец отображает покупателю QR код (для стран ЕС кроме Германии) и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код (для стран ЕС кроме Германии) или переходит по ссылке и совершает оплату.
  6. Demo PSP отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Demo PSP с помощью запроса получения статуса транзакции.
  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://demo-backoffice.begateway.com/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://demo-backoffice.begateway.com/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. Торговец отправляет в Demo PSP запрос оплаты, указав bank_transfer_revolut в качестве method.type.
  3. Demo PSP присылает в ответе ссылку на QR код и ссылку для оплаты.
  4. Продавец отображает покупателю QR код и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код или переходит по ссылке, авторизуется на сайте или в приложении Revolut и совершает оплату.
  6. Demo PSP отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Demo PSP с помощью запроса получения статуса транзакции.
  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://demo-backoffice.begateway.com/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. Торговец отправляет в Demo PSP запрос оплаты, указав bank_transfer_wise в качестве method.type.
  3. Demo PSP присылает в ответе ссылку на QR код и ссылку для оплаты.
  4. Продавец отображает покупателю QR код и ссылку из параметра redirect_url.
  5. Покупатель сканирует QR код или переходит по ссылке, авторизуется в приложении или на сайте Wise и совершает оплату.
  6. Demo PSP отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у Demo PSP с помощью запроса получения статуса транзакции.
  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://demo-backoffice.begateway.com/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
    }
  }
}