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

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

Вариант интеграции 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.

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

Запрос

Отправьте запрос оплаты со следующими данными:
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://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
    }
  }
}

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

Запрос

Отправьте запрос оплаты со следующими данными:
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://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. Торговец отображает покупателю статус оплаты.
Запрос

Отправьте запрос оплаты со следующими данными:
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://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. Торговец отображает покупателю статус оплаты.
Запрос

Отправьте запрос оплаты со следующими данными:
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://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
    }
  }
}