Метод для начала оплаты сделки. Начать оплату сделки можно только, если у нее текущий початку оплати угоди. Почати оплату угоди можна тільки, якщо у неї поточний статус "NEW". Для начала оплаты, нужно чтобы такие поля сделки как початку оплати, потрібно щоб такі поля угоди як productPrice, productWeight, buyerPhone были обязательно заполнены. Так же, обязательно на момент оплаты должны быть выбраны обработчик товара(это були обов'язково заповнені. Також обов'язково на момент оплати повинні бути обрані обробник товару (це поле handler.type) и платежная та платіжна система для оплаты оплати за товар (это це поле payment.type). В У свою очередьчергу, в зависимости от выбранной платежной системы для оплаты платежа за товар обязательные поля к заполнению перед началом оплаты тоже разные, так же это вличет за собой то, что передаваемые параметры в запросе в поле card тоже могут быть разные. Есть обязательные поля при оплате и для обработчиков, они зависят от выбранного обработчика.Обязательные поля для платежных залежності від обраної платіжної системи для оплати платежу за товар обов'язкові поля для заповнення перед початком оплати теж різні, а це призводить до того, що параметри, які передаються в запиті в полі card, також можуть бути різні. Є обов'язкові поля при оплаті і для обробника, вони залежать від обраного обробника.
Обов'язкові поля для платіжних систем:
UAPAY P2P: card.id, card.securityCode, device - передаються в запросе на оплату сделкизапиті при оплаті угоди, payment.cardToId - указываются при создании или обновлении сделки вказуються при створенні чи оновленні угоди.
UAPAY ECOM: card.id, card.securityCode, device - передаються в запросе на оплату сделкизапиті при оплаті угоди.
Обязательные Обов'язковіполя для обработчиковобробників:
NovaPoshta: recipientFirstName, recipientLastName, recipientPhone, recipientCityId, recipientOfficeId, senderCityId - указываются при создании или обновлении сделки вказуються при створенні чи оновленні угоди.
Custom: recipientFirstName, recipientLastName, recipientPhone - указываются при создании или обновлении сделки вказуються при створенні чи оновленні угоди.
...
Запит
| Method | POST |
| URL | /deals/{{dealId}}/payments |
...
Параметри запиту
| ПолеОбязательное | Обов'язковість | Тип | ОписаниеОпис | ПримерПриклад |
|---|---|---|---|---|
| {{dealId}} | ДаТак | String | ID сделкиугоди (либо або externalId, если якщо byExternalId=true), которую нужно оплатитьяку потрібно оплатити | "L8M95ER" |
| byExternalId | НетНі | Boolean | Для поиска сделки пошуку угоди по externalIdнужно передать , необхідно передати true | true |
| remoteIP | ДаТак | String | IP-адрес плательщикаадреса платника | "127.0.0.1" |
| card | НетНі | ObjectОбъект | с данными для начала оплатыОб'єкт з даними для початку оплати | |
| card.id | НетНі | String | Токен платежной карты плательщика в выбранной платежной системеплатіжної карти платника в обраній платіжній системі | "670ac99a-74d2-4259-b3d5-41907419e4cc" |
| card.securityCode | НетНі | String | CVV/CVC код карты плательщикакарти платника | "123" |
| device | Так | Object | Об'єкт з інформацією про браузер / пристрій платника | {"acceptHeader":"*/*","ip":"91.137.205.117","colorDepth":24,"javaEnabled":false,"language":"en-US","screenHeight":864,"screenWidth":1536, "windowHeight":734,"windowWidth":1479,"time":"2021-10-07T14:55:52.832Z","timezoneOffset":-180,"userAgent":"Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"} |
Приклад:
| Code Block | ||
|---|---|---|
| ||
POST /deals/L8M95ER/payments |
| Code Block | ||
|---|---|---|
| ||
{
"remoteIP": "127.0.0.1",
"card": {
"id": "670ac99a-74d2-4259-b3d5-41907419e4cc",
"securityCode": "123"
},
"device": {
"acceptHeader": "*/*",
"ip": "91.137.205.117",
"colorDepth": 24,
"javaEnabled": false,
"language": "en-US",
"screenHeight": 864,
"screenWidth": 1536,
"windowHeight": 734,
"windowWidth": 1479,
"time": "2021-10-07T14:55:52.832Z",
"timezoneOffset": -180,
"userAgent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.159 Safari/537.36"
}
} |
Параметри відповіді
| Поле | ОписаниеОпис |
|---|---|
| dataОбъект с ответом | Об'єкт з відповіддю |
| data.id | ID начавшего платежу, що почав оплату платежа |
| data.type | Тип платежной системы с помощью которой будет производиться оплата |
| платіжної системи, з допомогою якої буде виконана оплата |
Приклад:
| Code Block | ||
|---|---|---|
| ||
{
"data": {
"id": "444",
"type": "P2P"
}
} |