ЕРИП
Процесс оплаты
- Торговец отправляет в систему Overpay запрос на создание платежного требования, указав уникальный
account_number. - Overpay присылает в ответе инструкцию для завершения оплаты.
- Торговец отображает инструкцию покупателю.
- Покупатель завершает оплату в приложении своего банка.
- Overpay отправляет торговцу автоматическое уведомление с результатом оплаты.
Создание платежного требования
Запрос
Отправьте запрос оплаты со следующими данными:
|
|||||||||||||||||||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 100,
"currency": "BYN",
"description": "description",
"test": true,
"expired_at": "2025-05-01T15:00:00+01:00",
"tracking_id": "your_uniq_number",
"ip": "127.0.0.1",
"language": "en",
"notification_url": "https://merchant.ltd/notification",
"return_url": "https://merchant.ltd/return",
"customer": {
"first_name": "Иван",
"last_name": "Иванов",
"middle_name": "Иванович",
"country": "BY",
"city": "Минск",
"zip": "220050",
"address": "просп. Независимости, 10",
"phone": "17777777777",
"device_id": "12312312321fff67"
},
"method": {
"type": "erip",
"account_number": "1234567-1234567890"
}
}
}
Ответ
Если платежный запрос принят успешно, ответ будет выдан в виде JSON-сообщения, содержащего status. Такое же сообщение будет отправлено в уведомлении на notification_url после проведения оплаты.
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Пример ответа
{
"transaction": {
"uid": "5046a011-cbbc-4f90-be62-be26aab13253",
"type": "payment",
"status": "pending",
"amount": 100,
"currency": "BYN",
"description": "description",
"created_at": "2025-04-02T07:29:07Z",
"updated_at": "2025-04-02T07:29:11Z",
"method_type": "erip",
"receipt_url": "https://backoffice.overpay.io/customer/transactions/5046a011-cbbc-4f90-be62-be26aab13253/0f2bec00306efcea78f6feaf23bde471afd7ad2f748c64b1b060efb4b04767ff?language=en",
"payment": {
"status": "pending",
"gateway_id": 5202,
"ref_id": "85d1c616-39fc-4af0-951b-57181a2af70c",
"message": "Требование на оплату счета создано."
},
"erip": {
"request_id": null,
"service_no": null,
"account_number": "1234567-1234567890",
"transaction_id": null,
"instruction": [
"Платежи -> Магазин -> Оплата"
],
"service_info": [
"Введите номер заказа"
],
"receipt": [
"Спасибо за оплату"
],
"agent_code": null,
"agent_name": null,
"service_no_erip": "12345678",
"qr_code_raw": "MDAwMjAxMDEwMjEyMzI1NDAwMTBieS5yYXNjaGV0MDEwODEyMzQ1Njc4MTAxODEyMzQ1NjctMTIzNDU2Nzg5MDEyMDIxMjMzMjIwMDE4YnkuZXBvcy5iZUdhdGVUZXN0NTIwNDQ1Njc1MzAzOTMzNTQwNDEuMDA1NTAyMDI1ODAyTFQ1OTA5RGVtb1Rlc3RzNjAwN1ZpbG5pdXM2MjI4MDIxMTE3Nzc3Nzc3Nzc3MDMwOURlbW9UZXN0czY0MTkwMDAyZW4wMTA5RGVtb1Rlc3RzNTYwNDEuMDA2MzA0RTg1QQ==",
"qr_code": "data:image/png;base64, iVBORw0KGgoAAAANSUhEUgAAALEAAACxAQAAAACjUmFoAAADo0lEQVR4nO2WsW/bRhSH71SYkoe6iDuISmBRHiLPUQYrQwzUGWwNVWY7g2gBkaihKuoOpmhAPCoopUyF48GUjIjkYHauOlgeHKBeoqXOXHuQqAASOdgGnCEijerqPyDA09rCNz58+N33wLvHC9AvLhJAX1539bv6f7VOcTAfMJQSjpSyFRsTMEe2nwzW6gt2YUEVg2N4X1vuEvcvciCfHAo0NInnR41poZLafpacrC895rt/Bj8VD8kkPKcQe7H3mx2nPxbxCOYVbpBLT3Xl971MtxQAeUy9hLn9WNlOGn/s6pRAPA0MP1zPvY/EUtf8kAuCPGKOZGKqObo4L7zb+ATzvDNr+eYD9SOZyjZ0mG/fK+RVkd3MqEe6yoD9ovW0Tr7Lpt04v+ys+yCPv06KG80ofTrqH7+5KIA+VEqF7ilYc0y5gyb4XrjX4ohf3u/1oz5zWIT9rfRyzWiglmguDe0S6IM22SnVwbI9453b96NgPi322yLDP4/TwkNZcOH8/bfCq57hSWLY3t17BPNTAXFOSzOOe2rQUzgf27d31vAb/O+PO9a3v8D59ew+WVv0uEIR9ZlZuN/qErqZJheDzI48lCY4z3xK+L6r1OebV/MJJwP77yVyR6rTEH3vc4+B5xUNDbW+wa+EsL3NRQjoj0flGvvz22o3Fo4z5QrIo4aDqHB7TBm8ceLwMJ9jwwP2lVLtHGgWOwf6o0qFdy63IlypMJQqr2Eee4Unpap33ly7H43sgDzVLg9PosOZd1hFq/wVyGOVRawpicv0zUrS8GAfb0O66DaN8FcLpL/SRCB/yfKtfaWrZs5u93oB+yszv344rRN3CZnjtgXm4793tbbvFpIvgpr/7AzkaczxvUUSPrMYR3/6EPTBunahkJdZ/WSWEneC+dZxNqmioTRKNVM7XZBH+shKO2b8hoQlK92C+5Vq7oNuR7ToDI9aKTifDV9HWR+T6Mb8CIVh/54bWmeOCXvzqFO1v4Hza6xYey2hYSwfL4XWYD7/Aylv2dy1o3dDmTjYL6qParoioNrWtubFRZDHNBsmdrKP1VU89k3YB0XTWL3MD3zG8Mvw/47i6YRXP6NyVRYsB4E8knvO89ixIvmtjMCuwrxNkOGdR+K1q8Rm5WACf2qfuZynoZ8GTmmC9wNCc3skT9x/QqZqwfcLccQkL4PCLMrxRx14niMl1je19WPBlQyHToP87ftqnMO6PWa5nhiZ4P12V7+r/0/q/wK4EMbci6sW9QAAAABJRU5ErkJggg=="
},
"customer": {
"first_name": "Иван",
"last_name": "Иванов",
"middle_name": "Иванович",
"country": "BY",
"city": "Минск",
"zip": "220050",
"address": "просп. Независимости, 10",
"phone": "17777777777",
"device_id": "12312312321fff67",
"email": null,
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 0,
"message": "Требование на оплату счета создано.",
"tracking_id": "your_uniq_number",
"test": true,
"language": "en",
"expired_at": "2025-05-01T15:00:00+01:00",
"billing_address": {
"first_name": "Иван",
"last_name": "Иванов",
"middle_name": "Иванович",
"country": "BY",
"city": "Минск",
"zip": "220050",
"address": "просп. Независимости, 10",
"phone": "17777777777",
"device_id": "12312312321fff67"
},
"additional_data": {
"payment_method": {
"type": "erip"
}
},
"gateway": {
"iframe": false
}
}
}
Уведомления о ЕРИП платежах
Для информирования вашей IT-системы об изменениях статуса платежного требования и об осуществленной оплате Overpay использует механизм уведомлений на адрес, указанный в notification_url запроса.
Уведомления - это POST-запросы с вашими авторизационными данными и содержащие JSON-сообщения с данными платёжного требования.
Проверяйте авторизационные данные, чтобы убедиться, что запрос пришел от Overpay.
Уведомления приходят в случае изменения статуса операции на pending, expired, failed или successful.
Параметры автоматического уведомления совпадают с параметрами ответа на запрос на создание платежного требования.