:arrow_left: [На Головну](/eSq3juGWQLS1wVvJZiTUAQ)

# [50010] Створення шаблону рахунку

## Запит

*Опис атрибутів "Partner", "KeyAES" та "Sign" див. у розділі ["Загальна інформація по підключенню (API)"](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA).*

### Структура "Data"

Структура "Data" для даної операції формується з наступних параметрів:

:::info
<details>
<summary>Формування структури "Data" (приклади наведені нижче)</summary>
<br>

~~~
{
"Sum" : ,
"Recipient": "",
"RecipientName": "",
"Purpose": "",
"Order": "",
"DateTime": "",
"DateTimeExp": "",
"Transaction": {
"TransactionID": "",
"TerminalID": "",
"DateTime": ""
}
}
~~~
</details>
:::

| Параметр | Обов'яз-ковість | Тип | Опис | Приклад|
|:----:|:----:|:----:|----|:----:|
| `Sum` | Ні | Ціле | Сума операції у копійках. У разі відсутності поля `Sum` буде створено шаблон рахунку для сплати на будь-яку суму. | 1грн.=>`100` |
| `Recipient` | Так | Рядок | UUID (унікальний ідентифікатор) платіжного інструменту одержувача. |`ead5ea7a-f19f-44ec-8742-3621b4bfdc18`|
| `RecipientName` | Так | Рядок | ПІБ одержувача. |`Віщик Максим`|
| `Purpose` | Так | Рядок | Призначення платежу. |`Bristol accommodation 30/01-02/02/2023`|
| `Order` | Ні | Рядок | Номер рахунку у системі. |`59856`|
| `DateTime` | Так | Рядок | Дата/час виставлення рахунку. |`2023-01-23 15:17:33`|
| `DateTimeExp` | Ні | Рядок | Дата/час дії рахунку. |`2023-01-30 23:59:59`|
|`Transaction`|Так|Структура|Структура, що передає дані про транзакцію. Див. розділ ["Структура "Transaction"](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA#2-Data).|Див. нижче.|

:::success
<details>
<summary>Приклад запиту [50010]</summary>
<br>

~~~md
{
"Partner": {
"PartnerToken": "79f47e2e-c1c0-434d-b6f8-2edcebfd4e08",
"OperationType": 50010,
"Locale": "uk"
},
"Data": "{\"Sum\": 866087, \"Recipient\": \"8a38527f-3b73-4f13-8873-4e4f68b0f20c\", \"RecipientName\": \"Віщик Максим\", \"Purpose\": \"Bristol accommodation 30/01-02/02/2023\", \"Order\": \"59856\", \"DateTime\": \"2023-01-23 15:17:33\", \"DateTimeExp\": \"2023-01-30 23:59:59\", \"Transaction\": {\"TransactionID\": \"b6102c5e-14f2-4ff6-be23-4f3a376e56d9\", \"TerminalID\": \"1\", \"DateTime\": \"2023-01-23 15:17:33\"}}",
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

## Відповідь

*Загальна інформація по формуванню структури відповіді наведена у розділі [“Загальна інформація по підключенню (API)”](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA?both#%D0%A1%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B0-%D0%B2%D1%96%D0%B4%D0%BF%D0%BE%D0%B2%D1%96%D0%B4%D1%96).*

### Приклади відповідей

:::success
<details>
<summary>Операція по створенню шаблону рахунку проведена успішно</summary>
<br>

~~~md
{
"Code": 200,
"Message": "Bill template created!",
"Data": {
"BillTemplateURL": "https://qr.xpay.com.ua/111287?sum=5000",
"OperationDate": "2018-12-25T14:48:10.977847+02:00",
"OperationID": 167813,
"OperationStatus": 10
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

:::success
<details>
<summary>Помилка виконання операції</summary>
<br>

~~~md
{
"Code": 200,
"Message": "fail",
"Data": {
"OperationID": 111,
"OperationStatus": 21,
"Reason": 3
},
"KeyAES": "",
"Sign": ""
}
~~~
</details>
:::

## Довідкові матеріали

Опис загальних параметрів системи XPAY див. у розділі ["Довідкові матеріали"](https://hackmd.io/aBE7H5cfQ-iqaN3SnwaQ-w): коди типів операцій, типи платіжних методів, коди статусів обробки операцій, відомості та помилки, що повертаються у відповіді та ін.

## Cлужба підтримки
<details>
<summary>Контакти</summary>
</br>

Телефон: [phone]
email: [e-mail]
Telegram: @xpaysupportbot
</details>
</br>

:::info
**Навігація по API:**

:bookmark_tabs: [XPASS API Зміст](https://hackmd.io/eSq3juGWQLS1wVvJZiTUAQ)

:arrow_left: [Загальна інформація по підключенню (API)](https://hackmd.io/g3cItPVFStez0ql3Xj-2TA)
:::