Add payment

post

https://api-qecom.novapay.ua/v1/payment

Додавання інформації про замовлення до створеної платіжної сесії та отримання посилання на оплату. Метод використовується для оплати через платіжну сторінку NovaPay, маркетплейс та через нативні кнопки Apple Pay/Google Pay.

Під час оплати через нативні кнопки Apple Pay/Google Pay URL, отриманий у відповіді на запит, не використовується. Після отримання платіжного токена продовжте оплату методом POST /v1/pay-token.

Детальніше про інтеграцію та флоу оплати через нативні кнопки — Apple Pay і Google Pay на сайті мерчанта.

Для операцій маркетплейсу в тілі запиту необхідно додатково передати об’єкт marketplace_data з marketplace_id та marketplace_fee. Якщо хоча б один із параметрів не вказано, оплата буде виконана без зарахування комісії.

Body Params

merchant_id

string

required

Приклад: 2

session_id

string

required

Приклад: e982ebb2-b2ee-461b-bba5-4fc1e2a947c9

amount

float

required

Приклад: 100.25

promo_amount

string

Загальна сума до оплати з урахуванням знижки (за умови підключеної промоакції за BIN/МПС). Приклад: 89.00

external_id

string

Необов’язковий параметр, що вказує ідентифікатор замовлення у системі мерчанта (для реєстрів). Приклад: f364d3c7-af2c-4174-a336-fc5c9160671c

use_hold

boolean

Defaults to false

Необов’язковий параметр, що вказує на використання двоетапної оплати (холд, потім підтвердження). Якщо параметр не вказано — вважається, що значення false. Завжди встановлюйте true, якщо використовується параметр delivery

identifier

string

Необов’язковий параметр для створення платежу на користь отримувача, який відрізняється від основного мерчанта (за ЄДРПОУ). Приклад: 31316718

products

array of objects

Необов’язковий об’єкт, що містить дані про зміст замовлення

products

marketplace_data

object

Об’єкт використовується лише для операцій маркетплейсу. Передається в тілі запиту на одному рівні з merchant_id, session_id, amount, products та іншими параметрами. Використовується для передавання ідентифікатора маркетплейсу та суми комісії, яка має бути перерахована на користь маркетплейсу. Якщо хоча б один із параметрів не вказано, оплата буде виконана без зарахування комісії.

Responses

200200

400400