Оплата угоди

Метод для початку оплати угоди. Почати оплату угоди можна тільки, якщо у неї поточний статус "NEW". Для початку оплати, потрібно щоб такі поля угоди як productPrice, productWeight, buyerPhone були обов'язково заповнені. Також обов'язково на момент оплати повинні бути обрані обробник товару (це поле handler.type) та платіжна система для оплати за товар (це поле payment.type). У свою чергу, в залежності від обраної платіжної системи для оплати платежу за товар обов'язкові поля для заповнення перед початком оплати теж різні, а це призводить до того, що параметри, які передаються в запиті в полі card, також можуть бути різні. Є обов'язкові поля при оплаті і для обробника, вони залежать від обраного обробника.

Обов'язкові поля для платіжних систем:

UAPAY P2P: card.id, card.securityCode - передаються в запиті при оплаті угоди, payment.cardToId - вказуються при створенні чи оновленні угоди.

UAPAY ECOM: card.id, card.securityCode - передаються в запиті при оплаті угоди.

Обов'язкові поля для обробників:

NovaPoshta: recipientFirstNamerecipientLastNamerecipientPhonerecipientCityIdrecipientOfficeIdsenderCityId - вказуються при створенні чи оновленні угоди.

Custom: recipientFirstNamerecipientLastNamerecipientPhone - вказуються при створенні чи оновленні угоди.

Запит

MethodPOST
URL/deals/{{dealId}}/payments

Параметри запиту

ПолеОбов'язковістьТипОписПриклад
{{dealId}}ТакStringID угоди (або externalId, якщо byExternalId=true), яку потрібно оплатити"L8M95ER"
byExternalIdНіBooleanДля пошуку угоди по externalId, необхідно передати truetrue
remoteIPТакStringIP-адреса платника"127.0.0.1"
cardНіObjectОб'єкт з даними для початку оплати
card.idНіStringТокен платіжної карти платника в обраній платіжній системі"670ac99a-74d2-4259-b3d5-41907419e4cc"
card.securityCodeНіStringCVV/CVC код карти платника"123"

Приклад:

Параметри відповіді

ПолеОпис
dataОб'єкт з відповіддю
data.idID платежу, що почав оплату
data.typeТип платіжної системи, з допомогою якої буде виконана оплата

Приклад: