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

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

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

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в MerchantPay.
  3. MerchantPay присылает в ответе секцию form с полем action, содержащим URL страницы оплаты.
  4. Торговец перенаправляет покупателя на страницу из параметра form.action из ответа MerchantPay.
  5. Покупатель совершает платеж на странице оплаты.
  6. После завершения оплаты покупатель перенаправляется на return_url, указанный в запросе на оплату.
  7. MerchantPay отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у MerchantPay с помощью запроса получения статуса транзакции.
  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.universepay.eu/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": []
    }
  }
}

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

Оплата

Info

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

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

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

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращён покупатель после завершения оплаты.
ip
 string
IP-адрес покупателя.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
account_number
 string
IBAN счёта покупателя.
object
Секция информации о покупателе.
first_name
обязательный
 string
Имя покупателя.
last_name
обязательный
 string
Фамилия покупателя.
email
обязательный
 string
Email покупателя.
country
обязательный
 string
Страна покупателя в формате ISO 3166-1 Alpha-2.
external_id
 string
Идентификатор покупателя в системе торговца.
birth_date
 string
Дата рождения покупателя в формате ISO 8601 YYYY-MM-DD
phone
 string
Номер телефона покупателя без специальных символов.
address
 string (510)
Адрес покупателя.
city
 string (50)
Город покупателя.
zip
 string (12)
Почтовый индекс адреса покупателя.
state
 string (40)
Регион / штат покупателя.
Пример запроса 
{
    "request": {
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "test": true,
        "return_url": "https://return-url/",
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "example@example.com",
            "country": "BE"
        },
        "method": {
            "type": "bank_transfer",
            "account_number": "BE12345678901234"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "2b9073db-8548-4b1b-8d5a-bc60683f1cf3",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-06-09T15:31:57Z",
        "updated_at": "2026-06-09T15:32:03Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.universepay.eu/customer/transactions/2b9073db-8548-4b1b-8d5a-bc60683f1cf3/7aa7981fe4c827222def087e56d0dc9b32272a38ad74a5bc5175812fe386fa61",
        "payment": {
            "status": "pending",
            "gateway_id": 6749,
            "ref_id": "880cb9ffb30446379b17ff0f2423a8ae",
            "message": "Transaction was initialized."
        },
        "bank_transfer": {
            "type": "bank_transfer",
            "account_number": "BE12345678901234"
        },
        "customer": {
            "email": "example@example.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "email": "example@example.com",
            "country": "BE",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [],
            "method": "GET"
        }
    }
}

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

Оплата

Info

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

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

  1. Покупатель инициирует оплату на сайте торговца.
  2. Торговец отправляет запрос оплаты в MerchantPay.
  3. MerchantPay присылает в ответе секцию form с параметрами для формирования HTML-формы для завершения оплаты.
  4. Торговец перенаправляет покупателя на форму для завершения оплаты.
  5. Покупатель завершает оплату.
  6. MerchantPay отправляет торговцу автоматическое уведомление со статусом оплаты. Торговец также может запросить статус оплаты у MerchantPay с помощью запроса получения статуса транзакции.
Запрос

Отправьте запрос оплаты со следующими данными:
object
return_url
обязательный
 string
URL, на который будет возвращён покупатель после завершения оплаты.
object
Секция параметров способа оплаты.
type
обязательный
 string
bank_transfer
object
Секция информации о покупателе.
external_id
 string
Идентификатор покупателя в системе торговца. Рекомендуется передавать этот параметр в запросе.
first_name
 string
Имя покупателя.
last_name
 string
Фамилия покупателя.
email
 string
Email покупателя.
country
 string
Страна покупателя в формате ISO 3166-1 Alpha-2.
Пример запроса 
{
    "request": {
        "test": true,
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "return_url": "https://return.com",
        "method": {
            "type": "bank_transfer"
        },
        "customer": {
            "external_id": "12345ghj",
            "email": "example@example.com",
            "first_name": "John",
            "last_name": "Doe",
            "country": "FR"
        }
    }
}
Ответ

Создайте HTML-форму, используя параметры из секции form. Отправьте покупателя на форму для завершения оплаты.

Пример ответа 
{
    "transaction": {
        "uid": "399c96f2-7af5-4cac-a270-602af994ca21",
        "type": "payment",
        "status": "pending",
        "amount": 500,
        "currency": "EUR",
        "description": "description",
        "created_at": "2026-06-15T16:25:34Z",
        "updated_at": "2026-06-15T16:25:34Z",
        "method_type": "bank_transfer",
        "receipt_url": "https://backoffice.universepay.eu/customer/transactions/399c96f2-7af5-4cac-a270-602af994ca21/6fe6c8c1c4e0d938b9c8977ded59650e18954624f169e1717d470715e4cf46b9",
        "payment": {
            "status": "pending",
            "gateway_id": 6788,
            "message": "Transaction was initialized."
        },
        "bank_transfer": {
            "type": "bank_transfer",
            "use_pending_page": true
        },
        "customer": {
            "email": "example@example.com",
            "country": "FR",
            "last_name": "Doe",
            "first_name": "John",
            "external_id": "12345ghj",
            "ip": null
        },
        "manually_corrected_at": null,
        "version": 1,
        "message": "Transaction was initialized.",
        "test": true,
        "billing_address": {
            "email": "example@example.com",
            "country": "FR",
            "last_name": "Doe",
            "first_name": "John"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },
        "smart_routing_verification": {
            "status": "successful"
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "link-to-payment-page",
            "fields": [
                {
                    "name": "project_id",
                    "type": "hidden",
                    "value": 162661
                },
                {
                    "name": "payment_id",
                    "type": "hidden",
                    "value": "399c96f2-7af5-4cac-a270-602af994ca21"
                },
                {
                    "name": "payment_amount",
                    "type": "hidden",
                    "value": 500
                },
                {
                    "name": "payment_currency",
                    "type": "hidden",
                    "value": "EUR"
                },
                {
                    "name": "customer_id",
                    "type": "hidden",
                    "value": "12345ghj"
                },
                {
                    "name": "customer_first_name",
                    "type": "hidden",
                    "value": "John"
                },
                {
                    "name": "customer_last_name",
                    "type": "hidden",
                    "value": "Doe"
                },
                {
                    "name": "customer_email",
                    "type": "hidden",
                    "value": "example@example.com"
                },
                {
                    "name": "region_code",
                    "type": "hidden",
                    "value": "FR"
                },
                {
                    "name": "payment_description",
                    "type": "hidden",
                    "value": "description"
                },
                {
                    "name": "best_before",
                    "type": "hidden",
                    "value": "2026-06-16T16:25:34+00:00"
                },
                {
                    "name": "merchant_callback_url",
                    "type": "hidden",
                    "value": "https://apm.universepay.eu/beyag/transactions/notifications/2e54a8117d2b5218261da4aa981f6ea1d61c0a7445ba0c538c2235404d35643d"
                },
                {
                    "name": "redirect_success_url",
                    "type": "hidden",
                    "value": "https://apm.universepay.eu/beyag/transactions/returns/2e54a8117d2b5218261da4aa981f6ea1d61c0a7445ba0c538c2235404d35643d/399c96f2-7af5-4cac-a270-602af994ca21"
                },
                {
                    "name": "redirect_fail_url",
                    "type": "hidden",
                    "value": "https://apm.universepay.eu/beyag/transactions/returns/2e54a8117d2b5218261da4aa981f6ea1d61c0a7445ba0c538c2235404d35643d/399c96f2-7af5-4cac-a270-602af994ca21"
                },
                {
                    "name": "signature",
                    "type": "hidden",
                    "value": "NVowj2xkgo+4lnReqHAvN9nR7Lo0H7IZS/bUljBHoVCTZEordVB8H8Jf7vzbEPvbI7qPhxCXGFBfVK4KvjAJlg=="
                }
            ],
            "method": "POST"
        }
    }
}