/
Зміни в постбеках

Зміни в постбеках

Стандартний еквайринг

Додано:

  • client_email: Додано новий параметр для імейлу клієнта.

  • client_ip: Додано новий параметр для IP-адреси клієнта.

  • card_details: З'явився новий блок параметрів card_details, який містить деталі банківської картки:

    • pan: Переміщено з загального списку параметрів.

    • card_bank: Додано інформацію про банк-емітент картки.

    • card_country: Додано числовий код країни банку картки.

    • card_type: Додано тип платіжної системи картки (наприклад, MC).

Видалено:

  • delivery_amount: Параметр відсутній у новій структурі.

  • delivery_status_code: Параметр відсутній у новій структурі.

  • delivery_status_text: Параметр відсутній у новій структурі.

Зміни у порядку параметрів:

Окрім додавання нових параметрів, також змінився порядок деяких існуючих:

  • terminal_name та RRN перемістилися нижче у списку, слідуючи за client_email та client_ip.

  • external_id перемістився вище у списку, розмістившись між client_phone та client_email.

  • amount перемістився нижче, розмістившись перед новим блоком card_details.

  • Блок параметрів, що стосуються products (count, price, description), перемістився в кінець списку.

Загальна схема postback для стандартного еквайрингу

{ "id":"403cd18d-3af9-41443-795ba6cf29d4", "status":"holded", "paytype": "card", "terminal_name": "NE0031", "RRN": "123456789101", "created_at":"2022-11-17T12:33:50.875+00:00", "metadata":{ "order_id":"17189" }, "client_first_name":"Максим", "client_last_name":"Кумедний", "client_patronymic":"Максимович", "client_phone":"+380501112233", "external_id":"57-10578", "pan":"123456xxxx1234", "processing_result":"Successful", "amount":185, "delivery": { "recipient_city":"db5c8911-391c-11dd-90d9-001a92567626", "recipient_warehouse":"4f0184d3-8c45-11e9-898c-005056b24375" }, "products":[ { "count":1, "price":185, "description":"Мило Super" } ], "delivery_amount":"", "delivery_status_code":"", "delivery_status_text":"" }

Опис параметрів

Параметр

Назва українською

Параметр

Назва українською

id

Ідентифікатор сесії.

status

Статуси сесії описані тут.

paytype

Параметр способу оплати (card, applepay, googlepay).

terminal_name

Ідентифікатор платіжного термінала.

RRN

(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.

created_at

Дата та час створення операції.

metadata

Додаткові метадані сесії.

client_first_name

Ім'я клієнта.

client_last_name

Прізвище клієнта.

client_patronymic

По-батькові клієнта.

client_phone

Номер телефону клієнта.

external_id

Зовнішній ідентифікатор замовлення.

pan

Маскований номер платіжної картки.

processing_result

Опис статусу обробки (процесінгу).

amount

Сума замовлення.

delivery

Інформація про доставку.

recipient_city

Ідентифікатор міста отримувача.

recipient_warehouse

Ідентифікатор відділення отримувача.

products

Список товарів у замовленні.

count

Кількість одиниць товару.

price

Ціна за одиницю товару.

description

Опис товару.

delivery_amount

Вартість доставки.

delivery_status_code

Код статусу доставки.

delivery_status_text

Текстовий опис статусу доставки.

{ "id": "6ba513d6-01ea-4f7e-bacf-0700a3cff84f", "status": "holded", "paytype": "card", "created_at": "2025-07-24T12:30:37.508+00:00", "metadata": { "lol": "kek", "marketing_block_en": "Get bonus with visa card!", "marketing_block_uk": "Оплачуй карткою Visa та отримуй бонус!Оплачуй карткою Visa та отримуй бонус!" }, "client_first_name": "Яєчко", "client_last_name": "Пасхальне", "client_patronymic": "Куряче", "client_phone": "+380204050608", "client_email": "test@gmail.com", "client_ip": "10.0.0.2", "external_id": "33102-23", "terminal_name": null, "RRN": "8415523", "processing_result": "Successful", "amount": 6, "products": [ { "count": 1, "price": 51000, "description": "Eveline Cosmetics Wonder Match тональний крем з гіалуроновою кислотою та термальною водою для бездоганного покриття" }, { "count": 2, "price": 25000, "description": "Patricia Ledo Malachite палетка тіней для повік з насиченими відтінками та шовковистою текстурою" }, { "count": 1, "price": 25, "description": "Доставка" } ], "card_details": { "pan": "413417xxxx0292", "card_bank": "OTP BANK JSC", "card_country": "UKR", "card_type": "VISA" } }

Опис параметрів

Параметр

Назва українською

Параметр

Назва українською

id

Ідентифікатор сесії.

status

Статуси сесії описані тут.

paytype

Параметр способу оплати (card, applepay, googlepay).

created_at

Час створення платіжної сесії.

metadata

Додаткові мета-дані.

client_first_name

Ім’я клієнта.

client_last_name

Прізвище клієнта.

client_patronymic

По-батькові клієнта.

client_phone

Номер телефону клієнта.

client_email

Електронна пошта клієнта.

client_ip

ІР-адреса платника.

external_id

Зовнішній ідентифікатор замовлення.

terminal_name

Ідентифікатор платіжного термінала.

RRN

(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.

processing_result

Опис статусу обробки (процесінгу).

amount

Сума замовлення.

products

Список товарів.

count

Кількість одиниць товару.

price

Ціна за одну одиницю товару.

description

Текстовий опис товару.

card_details

Масив деталей картки.

pan

Маскований номер платіжної картки.

card_bank

Назва банку-емітента картки.

card_country

Числовий код країни, в якій було видано картку.

card_type

Тип платіжної системи картки.

Чекаут

Зміни застосовані для трьох типів постбеку:

  1. Postback після оплати.

  2. Postback після створення ЕН.

  3. Postback із причиною невдалого створення ЕН.

Додано:

  • client_email: Додано новий параметр для електронної пошти клієнта.

  • client_ip: Додано новий параметр для IP-адреси клієнта.

  • terminal_name: З'явився новий параметр, що містить назву терміналу.

  • card_details: З'явився новий блок параметрів card_details, який містить деталі банківської картки. Цей блок включає:

    • pan: Переміщено з загального списку параметрів.

    • card_bank: Додано інформацію про банк-емітент картки.

    • card_country: Додано числовий код країни банку картки.

    • card_type: Додано тип платіжної системи картки (наприклад, MC).

  • RRN: Додано новий параметр RRN.

  • processing_result: Додано новий параметр, що вказує на результат обробки платежу.

  • recipient_city_description: Додано опис міста отримувача у блок delivery.

  • recipient_warehouse_description: Додано опис складу отримувача у блок delivery.

  • recipient_address: Додано повну адресу отримувача у блок delivery.

Видалено:

  • З параметра delivery видалено деталі отримувача: recipient_phone, recipient_last_name, recipient_first_name, recipient_patronymic.

Postback після оплати

{ "id": "f1c86ec3-45ff-4bde-a428-37f49bcde530", "status": "paid", "paytype": "cash_on_delivery", "created_at": "2025-03-10T15:56:29.169+02:00", "metadata": { "lol": "kek", "marketing_block_en": "Get bonus with visa card!", "marketing_block_uk": "Оплачуй карткою Visa та отримуй бонус!Оплачуй карткою Visa та отримуй бонус!" }, "client_first_name": "Іван", "client_last_name": "Іваненко", "client_patronymic": "Іванович", "client_phone": "+380111111111", "external_id": null, "amount": 53, "delivery": { "recipient_city": "526b41b7-f344-48ad-becf-17544ff460e5", "recipient_warehouse": "526b41b7-f344-48ad-becf-17544ff460e6", "recipient_phone": "+380222222222", "recipient_last_name": "Андрієнко", "recipient_first_name": "Андрій", "recipient_patronymic": "Андрійович" }, "products": [ { "count": 1, "image": "https://i.pinimg.com/736x/a3/b9/ca/a3b9cab8583db63b6eadcd7e9746cba6.jpg", "price": 17, "description": "Заліпуха" }, { "count": 2, "image": "https://i.pinimg.com/736x/68/e5/24/68e52437158ced28ada0afc77582eb3f.jpg", "price": 18, "description": "Плащ-пальто" } ] }

Опис параметрів

Параметр

Обов'язковий

Опис

Параметр

Обов'язковий

Опис

id

Так

Унікальний ідентифікатор сесії.

status

Так

Статуси оплати описані тут (paid, holded, тощо).

paytype

Так

Тип оплати (cash_on_delivery, card, applepay, тощо).

created_at

Так

Дата та час створення операції.

metadata

Ні

Додаткові метадані сесії.

client_first_name

Так

Ім’я клієнта.

client_last_name

Так

Прізвище клієнта.

client_patronymic

Ні

По-батькові клієнта.

client_phone

Так

Номер телефону клієнта.

external_id

Ні

Зовнішній ідентифікатор замовлення.

amount

Так

Сума замовлення.

delivery

Так

Інформація про доставку.

recipient_city

Так

Ідентифікатор міста отримувача.

recipient_warehouse

Так

Ідентифікатор відділення отримувача.

recipient_phone

Так

Телефон отримувача.

recipient_last_name

Так

Прізвище отримувача.

recipient_first_name

Так

Ім’я отримувача.

recipient_patronymic

Ні

По батькові отримувача.

products

Так (якщо є products)

Список товарів у замовленні.

count

Так (якщо є products)

Кількість одиниць товару.

image

Ні

Посилання на зображення товару.

price

Так (якщо є products)

Ціна за одиницю товару.

description

Так (якщо є products)

Опис товару.

 

{ "id": "bb818bfc-360d-421f-85d9-d29cbc56f895", "status": "paid", "paytype": "card", "created_at": "2025-07-24T12:38:14.409+00:00", "metadata": null, "client_first_name": "Марія", "client_last_name": "Москаленко", "client_patronymic": null, "client_phone": "+380989554740", "client_email": null, "client_ip": "10.0.0.2", "external_id": "RE123654789", "terminal_name": null, "RRN": "8415557", "processing_result": "Successful", "amount": 11, "delivery": { "recipient_city": "1b009444-4e4a-11ed-a361-48df37b92096", "recipient_city_description": "с. Абранка", "recipient_warehouse": "cb7a3e6a-4f93-11ed-9eb1-d4f5ef0df2b8", "recipient_warehouse_description": "Пункт приймання-видачі (до 30 кг): вул. б/н 46", "recipient_address": "с. Абранка, Пункт приймання-видачі (до 30 кг): вул. б/н 46" }, "products": [ { "count": 1, "image": "https://images.unsplash.com/photo-1503236823255-94609f598e71?q=80&w=2069&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D", "price": 1700, "description": "Eveline Cosmetics Wonder Match тональний крем з гіалуроновою кислотою та термальною водою для бездоганного покриття" }, { "count": 1, "image": "https://images.unsplash.com/photo-1503236823255-94609f598e71?q=80&w=2069&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D", "price": 1700, "description": "Eveline Cosmetics Wonder Match тональний крем з гіалуроновою кислотою та термальною водою для бездоганного покриття" }, { "count": 1, "image": "https://images.unsplash.com/photo-1503236823255-94609f598e71?q=80&w=2069&auto=format&fit=crop&ixlib=rb-4.0.3&ixid=M3wxMjA3fDB8MHxwaG90by1wYWdlfHx8fGVufDB8fHx8fA%3D%3D", "price": 1700, "description": "Eveline Cosmetics Wonder Match тональний крем з гіалуроновою кислотою та термальною водою для бездоганного покриття" } ], "card_details": { "pan": "413417xxxx0292", "card_bank": "OTP BANK JSC", "card_country": "UKR", "card_type": "VISA" } }

Опис параметрів

Параметр

Опис

Параметр

Опис

id

Унікальний ідентифікатор сесії.

status

Статуси оплати описані тут (paid, holded, тощо).

paytype

Тип оплати (cash_on_delivery, card, applepay, тощо).

created_at

Дата та час створення операції.

metadata

Додаткові мета-дані.

client_first_name

Ім’я клієнта.

client_last_name

Прізвище клієнта.

client_patronymic

По-батькові клієнта.

client_phone

Номер телефону клієнта.

client_email

Електронна пошта клієнта.

client_ip

ІР-адреса платника.

external_id

Зовнішній ідентифікатор замовлення.

terminal_name

Ідентифікатор платіжного термінала.

RRN

(Reference Retrieval Number) — генерується платіжним провайдером (PSP) і використовується для ідентифікації транзакції.

processing_result

Опис статусу обробки (процесінгу).

amount

Сума замовлення.

delivery

Інформація про доставку.

In NovaPay We Trust