UAPAY - національний платіжний сервіс

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 22 Next »

Метод для создание сделки. Cделка создается со статусом "NEW", так же, если указаны данные по обработчику, то создаеться обработчик со статусом "NEW" и платеж за доставку со статусом "NEW", если указанные данные по платежу за товар, то создаеться платеж за товар со статусом "NEW". Обязательным, при создании, являеться только поле корзины, это позволяет обновлять сделку с помощью метода обновления сделки последующими итерациями  и не указывать все необходимые данные сразу.

При указании объявления, такие поля как sellerFirstName, sellerLastName, sellerPatronymic, sellerPhone, sellerEmail, productTitle, productPrice, productWeight заполняються автоматически с полей объявления. 

В сделке продавец не является обязательно отправителем, так же покупатель не являеться обязательно получателем.

Запрос

MethodPOST
URL/deals

Параметры запроса

ПолеОбязательноеТипОписаниеПример
externalIdНетStringВнешний ID, должен быть уникальным"myExternalId537916"
adIdНетStringID объявления, объявления должно быть подтвержденно(статус - "CONFIRMED")"A-D7ZL93Z"
cartIdДаNumberID корзины338
cartExternalIdДа, если не указан cartId StringВнешний ID корзины"myExternalId478454"
productTitleНетStringНазвание товара"Стол"
productWeightНетNumberВес товара, в граммах, только целые числа, больше нуля15000
productPriceНетNumberЦена товара в копейках, валюта - гривна, только целые числа, больше нуля100000
sellerFirstNameНетStringИмя продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иван"
sellerLastNameНетStringФамилия продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванов"
sellerPatronymicНетStringОтчество продавца, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванович"
sellerPhoneНетStringНомер телефона продавца в формате "380XXXXXXXXX""380123456789"
sellerEmailНетStringЭлектронная почта продавца"ivanov@mail.test"
buyerFirstNameНетStringИмя покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петро"
buyerLastNameНетStringФамилия покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петров"
buyerPatronymicНетStringОтчество покупателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петрович"
buyerPhoneНетStringНомер телефона покупателя в формате "380XXXXXXXXX""380987654321"
buyerEmailНетStringЭлектронная почта покупателя"petrov@mail.test"
paymentНетObjectОбъект с данными платежа за товар
payment.typeНетStringТип платежной системы с помощью которой будет производиться оплата товара"P2P"
payment.cardToIdНетStringТокен платежной карты продавца в выбранной платежной системе, куда будут зачислены деньги после успешной сделки"b0be0af6-9c7e-4b62-bf16-9957b34549c9"
handlerНетObjectОбъект с данными обработчика
handler.typeНетStringТип обработчика с помощью которого будет производиться доставка товара"NovaPoshta"
handler.senderFirstNameНетStringИмя отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иван"
handler.senderLastNameНетStringФамилия отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванов"
handler.senderPatronymicНетStringОтчество отправителя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Иванович"
handler.senderPhoneНетStringНомер телефона отправителя в формате "380XXXXXXXXX""380987654321"
handler.senderEmailНетStringЭлектронная почта отправителя"ivanov@mail.test"
handler.senderCityIdНетStringID города в системе выбранного обработчика с которого будет осуществлена отправка"8d5a980d-391c-11dd-90d9-001a92567626"
handler.senderOfficeIdНетStringID отделения/офиса в системе выбранного обработчика с которого будет осуществлена отправка

"7b2cc7fd-84ff-11e4-acce-0050568002cf"

handler.recipientFirstNameНетStringИмя получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петро"
handler.recipientLastNameНетStringФамилия получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петров"
handler.recipientPatronymicНетStringОтчество получателя, только кириллические символы украинского и русского алфавита, а так же апостроф. Не разрешается повторение одного и того же символа более 2 раз"Петрович"
handler.recipientPhoneНетStringНомер телефона получателя в формате "380XXXXXXXXX""380987654321"
handler.recipientEmailНетStringЭлектронная почта получателя"petrov@mail.test"
handler.recipientCityIdНетStringID города в системе выбранного обработчика в который будет осуществлена отправка"8d5a980d-391c-11dd-90d9-001a92567626"
handler.recipientOfficeIdНетStringID отделения/офиса в системе выбранного обработчика в который будет осуществлена отправка"1ec09d88-e1c2-11e3-8c4a-0050568002cf"

Пример:

POST /deals
{
  "externalId": "myExternalId537916",
  "adId": "A-D7ZL93Z",
  "cartId": 338,
  "productTitle": "Стол",
  "productWeight": 15000,
  "productPrice": 100000,
  "sellerFirstName": "Иван",
  "sellerLastName": "Иванов",
  "sellerPatronymic": "Иванович",
  "sellerPhone": "380123456789",
  "sellerEmail": "ivanov@mail.test",
  "buyerFirstName": "Петро",
  "buyerLastName": "Петров",
  "buyerPatronymic": "Петрович",
  "buyerPhone": "380987654321",
  "buyerEmail": "petrov@mail.test",
  "payment": {
    "type": "P2P",
    "cardToId": "058a2fa1-8dee-4c39-8796-574cdc573530"
  },
  "handler": {
    "type": "NovaPoshta",
    "senderFirstName": "Иван",
    "senderLastName": "Иванов",
    "senderPatronymic": "Иванович",
    "senderPhone": "380987654321",
    "senderEmail": "ivanov@mail.test",
    "senderCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
    "senderOfficeId": "7b2cc7fd-84ff-11e4-acce-0050568002cf",
    "recipientFirstName": "Петро",
    "recipientLastName": "Петров",
    "recipientPatronymic": "Петрович",
    "recipientPhone": "380987654321",
    "recipientEmail": "petrov@mail.test",
    "recipientCityId": "8d5a980d-391c-11dd-90d9-001a92567626",
    "recipientOfficeId": "1ec09d88-e1c2-11e3-8c4a-0050568002cf"
  }
}

Параметры ответа

ПолеОписание
dataОбъект с ответом
data.idID сделки
data.externalId

Внешний ID сделки

Пример:

{
    "data": {
        "id": "L8M95ER",
        "externalId": "myExternalId537916"
    }
}
  • No labels

UAPAY - національний платіжний сервіс
pay@uapay.ua