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

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

Вариант интеграции 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": []
    }
  }
}