> For the complete documentation index, see [llms.txt](https://api-portal.novapost.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-portal.novapost.com/api-docs-ua/zagalna-informaciya/oplati.md).
# Оплати
:link:[*Початок роботи з API*](https://api-portal.novapost.com/api-docs-ua)
## Розшифрувати вартість ЕН (JSON)
> Метод \*\*tlGetRecipientPaymentInfo\*\* моделі \*\*PaymentGeneral\*\*\
> використовується для розшифрування вартості експрес-накладної (ЕН) відповідно до наданих послуг.
```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Payment","version":"2.0.0"},"tags":[{"name":"Payment","description":"Операції, пов'язані з платежами та розрахунками"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/json/":{"post":{"tags":["Payment"],"operationId":"getRecipientPaymentInfoJson","summary":"Розшифрувати вартість ЕН (JSON)","description":"Метод **tlGetRecipientPaymentInfo** моделі **PaymentGeneral**\nвикористовується для розшифрування вартості експрес-накладної (ЕН) відповідно до наданих послуг.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecipientPaymentInfoJsonRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (JSON)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetRecipientPaymentInfoResponse"}}}}}}}},"components":{"schemas":{"GetRecipientPaymentInfoJsonRequest":{"type":"object","additionalProperties":false,"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["PaymentGeneral"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["tlGetRecipientPaymentInfo"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetRecipientPaymentInfoMethodProperties"}}},"GetRecipientPaymentInfoMethodProperties":{"type":"object","additionalProperties":false,"required":["pays"],"properties":{"Language":{"type":"string","maxLength":36,"description":"Мова"},"Document":{"type":"string","maxLength":36,"description":"Номер експрес-накладної (ЕН)"},"pays":{"type":"array","description":"Блок із реквізитами для контролю оплати (КО) / поділу КО на рахунки","items":{"$ref":"#/components/schemas/PayItem"}}}},"PayItem":{"type":"object","description":"Блок із реквізитами для контролю оплати (КО) / поділу КО на рахунки","additionalProperties":false,"required":["paycode","paysum"],"properties":{"paycode":{"type":"string","description":"Код оплати"},"paysum":{"type":"number","description":"Сума оплати"}}},"GetRecipientPaymentInfoResponse":{"type":"object","additionalProperties":false,"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив розшифрування вартості ЕН","items":{"$ref":"#/components/schemas/GetRecipientPaymentInfoItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","items":{"type":"string"}},"warnings":{"type":"array","description":"Масив попереджень","items":{"type":"string"}},"info":{"type":"array","description":"Масив інформаційних повідомлень","items":{"type":"string"}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","items":{"type":"string"}},"errorCodes":{"type":"array","description":"Масив кодів помилок","items":{"type":"string"}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","items":{"type":"string"}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","items":{"type":"string"}}}},"GetRecipientPaymentInfoItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) експрес-накладної (ЕН)"},"Number":{"type":"string","maxLength":36,"description":"Номер експрес-накладної (ЕН)"},"Services":{"type":"string","maxLength":36,"description":"Сума до сплати за послуги доставки. Сума зазначена, якщо ЕН не оплачена"},"AfterPayment":{"type":"string","maxLength":36,"description":"Сума до сплати за контроль оплати (КО). Сума зазначена, якщо ЕН не оплачена"},"MoneyTransfer":{"type":"string","maxLength":36,"description":"Сума до сплати за грошовий переказ (ГП). Сума зазначена, якщо ЕН не оплачена"},"Commission":{"type":"string","maxLength":36,"description":"Комісія за грошовий переказ (ГП). Сума зазначена, якщо ЕН не оплачена"},"ServicesPaid":{"type":"string","maxLength":36,"description":"Сума оплачених послуг доставки"},"AfterPaymentPaid":{"type":"string","maxLength":36,"description":"Оплачена сума за послугу «Контроль оплати» (КО)"},"MoneyTransferPaid":{"type":"string","maxLength":36,"description":"Оплачена сума за грошовий переказ (ГП)"},"TotalServices":{"type":"string","maxLength":36,"description":"Загальна сума послуг доставки"},"TotalAfterPayment":{"type":"string","maxLength":36,"description":"Загальна сума контролю оплати (КО)"},"TotalMoneyTransfer":{"type":"string","maxLength":36,"description":"Загальна вартість за послугу «Грошовий переказ» (сума грошового переказу + комісія за грошовий переказ)"},"Cash2CardPayout_Id":{"type":"string","maxLength":36,"description":"Токен для поточного с2с (Сash2Card)"},"Cash2CardSource":{"type":"string","maxLength":36,"description":"Канал замовлення послуги с2с (Сash2Card). Можливі значення: cashdesk або mobile"},"SecurePayment":{"type":"string","maxLength":36,"description":"Ознака наявності послуги «Сейф-Сервіс» в ЕН. Можливі значення: true — послуга замовлена, false — послуга не замовлена"},"PaymentPromocode":{"type":"string","maxLength":36,"description":"Використання промокоду в ЕН. Можливі значення: true — не використано, false — застосований"},"InternationalDelivery":{"type":"string","maxLength":36,"description":"Сума до сплати за послуги міжнародної доставки (МД)"},"InternationalDeliveryPaid":{"type":"string","maxLength":36,"description":"Сума, що оплачена за послуги міжнародної доставки (МД)"},"TotalInternationalDelivery":{"type":"string","maxLength":36,"description":"Загальна сума за послуги міжнародної доставки"},"ServicesList":{"type":"array","description":"Розшифрування послуг","items":{"$ref":"#/components/schemas/ServiceItem"}},"PaymentLoyalty":{"type":"string","maxLength":36,"description":"Суму доставки + комісію від оціночної вартості (ОВ) оплачено. Можливі значення: true — не оплачені, false — сплачені"},"ServiceType":{"type":"string","maxLength":36,"description":"Тип доставки"},"WarehouseRecipientRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) складу"},"UseNovaPay":{"type":"string","maxLength":36,"description":"Ознака для можливості оплати в Нова Пей онлайн та виведення фрейму. Можливі значення: null — все оплачено, true — можна викликати фрейм оплати"},"ServicesListMoneyTransfer":{"type":"array","description":"Розшифрування для грошового переказу (ГП)","items":{"$ref":"#/components/schemas/ServiceMoneyTransferItem"}},"CommissionPaid":{"type":"string","maxLength":36,"description":"Сплачена комісія"}}},"ServiceItem":{"type":"object","additionalProperties":false,"properties":{"Service":{"type":"string","format":"uuid","description":"Ідентифікатор послуги"},"ServiceName":{"type":"string","description":"Найменування послуги для виведення в інтерфейсі"},"Amount":{"type":"string","description":"Зона тарифу"},"Cost":{"type":"string","description":"Вартість"},"RoundCost":{"type":"string","description":"Округлена вартість"},"Paid":{"type":"string","description":"Сума, що оплачена"},"ServiceType":{"type":"string","description":"Тип послуги"},"OperationType":{"type":"string","description":"Тип операції"}}},"ServiceMoneyTransferItem":{"type":"object","additionalProperties":false,"properties":{"Service":{"type":"string","format":"uuid","description":"Ідентифікатор послуги «Грошовий переказ»"},"ServiceName":{"type":"string","description":"Найменування послуги «Грошовий переказ»"},"Amount":{"type":"string","description":"Зона тарифу, в цій послузі не заповнюється"},"Paid":{"type":"string","description":"Заповнено, якщо грошовий переказ оплачено"},"Cost":{"type":"string","description":"Сума грошового переказу"}}}}}}
```
## Розшифрувати вартість ЕН (XML)
> Метод \*\*tlGetRecipientPaymentInfo\*\* моделі \*\*PaymentGeneral\*\*\
> дозволяє отримати розшифрування вартості експрес-накладної (ЕН) у форматі XML.
```json
{"openapi":"3.0.3","info":{"title":"API Nova Post — Payment","version":"2.0.0"},"tags":[{"name":"Payment","description":"Операції, пов'язані з платежами та розрахунками"}],"servers":[{"url":"https://api.novaposhta.ua/v2.0/","description":"production"}],"paths":{"/xml/":{"post":{"tags":["Payment"],"operationId":"getRecipientPaymentInfoXml","summary":"Розшифрувати вартість ЕН (XML)","description":"Метод **tlGetRecipientPaymentInfo** моделі **PaymentGeneral**\nдозволяє отримати розшифрування вартості експрес-накладної (ЕН) у форматі XML.\n","requestBody":{"required":true,"content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetRecipientPaymentInfoXmlRequest"}}}},"responses":{"200":{"description":"Успішна відповідь (XML)","content":{"application/xml":{"schema":{"$ref":"#/components/schemas/GetRecipientPaymentInfoXmlResponse"}}}}}}}},"components":{"schemas":{"GetRecipientPaymentInfoXmlRequest":{"type":"object","additionalProperties":false,"xml":{"name":"file"},"required":["apiKey","modelName","calledMethod","methodProperties"],"properties":{"apiKey":{"type":"string","description":"API-ключ користувача"},"modelName":{"type":"string","enum":["PaymentGeneral"],"description":"Назва моделі API"},"calledMethod":{"type":"string","enum":["tlGetRecipientPaymentInfo"],"description":"Назва методу API"},"methodProperties":{"$ref":"#/components/schemas/GetRecipientPaymentInfoXmlMethodProperties"}}},"GetRecipientPaymentInfoXmlMethodProperties":{"type":"object","additionalProperties":false,"xml":{"name":"methodProperties"},"required":["pays"],"properties":{"Language":{"type":"string","maxLength":36,"description":"Мова"},"Document":{"type":"string","maxLength":36,"description":"Номер експрес-накладної (ЕН)"},"pays":{"type":"array","description":"Блок із реквізитами для контролю оплати (КО) / поділу КО на рахунки","xml":{"name":"pays","description":"Блок із реквізитами для контролю оплати (КО) / поділу КО на рахунки"},"items":{"$ref":"#/components/schemas/PayXmlItem"}}}},"PayXmlItem":{"allOf":[{"$ref":"#/components/schemas/PayItem"}],"xml":{"name":"item"}},"PayItem":{"type":"object","description":"Блок із реквізитами для контролю оплати (КО) / поділу КО на рахунки","additionalProperties":false,"required":["paycode","paysum"],"properties":{"paycode":{"type":"string","description":"Код оплати"},"paysum":{"type":"number","description":"Сума оплати"}}},"GetRecipientPaymentInfoXmlResponse":{"type":"object","additionalProperties":false,"xml":{"name":"root"},"required":["success","data","errors","warnings","info","messageCodes","errorCodes","warningCodes","infoCodes"],"properties":{"success":{"type":"boolean","description":"Прапор успішності виконання запиту"},"data":{"type":"array","description":"Масив розшифрування вартості ЕН","xml":{"name":"data","wrapped":true},"items":{"$ref":"#/components/schemas/GetRecipientPaymentInfoXmlItem"}},"errors":{"type":"array","description":"Масив повідомлень про помилки","xml":{"name":"errors","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warnings":{"type":"array","description":"Масив попереджень","xml":{"name":"warnings","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"info":{"type":"array","description":"Масив інформаційних повідомлень","xml":{"name":"info","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"messageCodes":{"type":"array","description":"Масив кодів інформаційних повідомлень","xml":{"name":"messageCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"errorCodes":{"type":"array","description":"Масив кодів помилок","xml":{"name":"errorCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"warningCodes":{"type":"array","description":"Масив кодів попереджень","xml":{"name":"warningCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}},"infoCodes":{"type":"array","description":"Масив кодів додаткової інформації","xml":{"name":"infoCodes","wrapped":true},"items":{"type":"string","xml":{"name":"item"}}}}},"GetRecipientPaymentInfoXmlItem":{"allOf":[{"$ref":"#/components/schemas/GetRecipientPaymentInfoItem"}],"properties":{"ServicesList":{"type":"array","description":"Розшифрування послуг","xml":{"name":"ServicesList","wrapped":true},"items":{"$ref":"#/components/schemas/ServiceXmlItem"}},"ServicesListMoneyTransfer":{"type":"array","description":"Розшифрування для грошового переказу (ГП)","xml":{"name":"ServicesListMoneyTransfer","wrapped":true},"items":{"$ref":"#/components/schemas/ServiceMoneyTransferXmlItem"}}},"xml":{"name":"item"}},"GetRecipientPaymentInfoItem":{"type":"object","additionalProperties":false,"properties":{"Ref":{"type":"string","format":"uuid","maxLength":36,"description":"Ідентифікатор (REF) експрес-накладної (ЕН)"},"Number":{"type":"string","maxLength":36,"description":"Номер експрес-накладної (ЕН)"},"Services":{"type":"string","maxLength":36,"description":"Сума до сплати за послуги доставки. Сума зазначена, якщо ЕН не оплачена"},"AfterPayment":{"type":"string","maxLength":36,"description":"Сума до сплати за контроль оплати (КО). Сума зазначена, якщо ЕН не оплачена"},"MoneyTransfer":{"type":"string","maxLength":36,"description":"Сума до сплати за грошовий переказ (ГП). Сума зазначена, якщо ЕН не оплачена"},"Commission":{"type":"string","maxLength":36,"description":"Комісія за грошовий переказ (ГП). Сума зазначена, якщо ЕН не оплачена"},"ServicesPaid":{"type":"string","maxLength":36,"description":"Сума оплачених послуг доставки"},"AfterPaymentPaid":{"type":"string","maxLength":36,"description":"Оплачена сума за послугу «Контроль оплати» (КО)"},"MoneyTransferPaid":{"type":"string","maxLength":36,"description":"Оплачена сума за грошовий переказ (ГП)"},"TotalServices":{"type":"string","maxLength":36,"description":"Загальна сума послуг доставки"},"TotalAfterPayment":{"type":"string","maxLength":36,"description":"Загальна сума контролю оплати (КО)"},"TotalMoneyTransfer":{"type":"string","maxLength":36,"description":"Загальна вартість за послугу «Грошовий переказ» (сума грошового переказу + комісія за грошовий переказ)"},"Cash2CardPayout_Id":{"type":"string","maxLength":36,"description":"Токен для поточного с2с (Сash2Card)"},"Cash2CardSource":{"type":"string","maxLength":36,"description":"Канал замовлення послуги с2с (Сash2Card). Можливі значення: cashdesk або mobile"},"SecurePayment":{"type":"string","maxLength":36,"description":"Ознака наявності послуги «Сейф-Сервіс» в ЕН. Можливі значення: true — послуга замовлена, false — послуга не замовлена"},"PaymentPromocode":{"type":"string","maxLength":36,"description":"Використання промокоду в ЕН. Можливі значення: true — не використано, false — застосований"},"InternationalDelivery":{"type":"string","maxLength":36,"description":"Сума до сплати за послуги міжнародної доставки (МД)"},"InternationalDeliveryPaid":{"type":"string","maxLength":36,"description":"Сума, що оплачена за послуги міжнародної доставки (МД)"},"TotalInternationalDelivery":{"type":"string","maxLength":36,"description":"Загальна сума за послуги міжнародної доставки"},"ServicesList":{"type":"array","description":"Розшифрування послуг","items":{"$ref":"#/components/schemas/ServiceItem"}},"PaymentLoyalty":{"type":"string","maxLength":36,"description":"Суму доставки + комісію від оціночної вартості (ОВ) оплачено. Можливі значення: true — не оплачені, false — сплачені"},"ServiceType":{"type":"string","maxLength":36,"description":"Тип доставки"},"WarehouseRecipientRef":{"type":"string","maxLength":36,"description":"Ідентифікатор (REF) складу"},"UseNovaPay":{"type":"string","maxLength":36,"description":"Ознака для можливості оплати в Нова Пей онлайн та виведення фрейму. Можливі значення: null — все оплачено, true — можна викликати фрейм оплати"},"ServicesListMoneyTransfer":{"type":"array","description":"Розшифрування для грошового переказу (ГП)","items":{"$ref":"#/components/schemas/ServiceMoneyTransferItem"}},"CommissionPaid":{"type":"string","maxLength":36,"description":"Сплачена комісія"}}},"ServiceItem":{"type":"object","additionalProperties":false,"properties":{"Service":{"type":"string","format":"uuid","description":"Ідентифікатор послуги"},"ServiceName":{"type":"string","description":"Найменування послуги для виведення в інтерфейсі"},"Amount":{"type":"string","description":"Зона тарифу"},"Cost":{"type":"string","description":"Вартість"},"RoundCost":{"type":"string","description":"Округлена вартість"},"Paid":{"type":"string","description":"Сума, що оплачена"},"ServiceType":{"type":"string","description":"Тип послуги"},"OperationType":{"type":"string","description":"Тип операції"}}},"ServiceMoneyTransferItem":{"type":"object","additionalProperties":false,"properties":{"Service":{"type":"string","format":"uuid","description":"Ідентифікатор послуги «Грошовий переказ»"},"ServiceName":{"type":"string","description":"Найменування послуги «Грошовий переказ»"},"Amount":{"type":"string","description":"Зона тарифу, в цій послузі не заповнюється"},"Paid":{"type":"string","description":"Заповнено, якщо грошовий переказ оплачено"},"Cost":{"type":"string","description":"Сума грошового переказу"}}},"ServiceXmlItem":{"allOf":[{"$ref":"#/components/schemas/ServiceItem"}],"xml":{"name":"item"}},"ServiceMoneyTransferXmlItem":{"allOf":[{"$ref":"#/components/schemas/ServiceMoneyTransferItem"}],"xml":{"name":"item"}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://api-portal.novapost.com/api-docs-ua/zagalna-informaciya/oplati.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.