> 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/metodi-1/metodi/readme/oplata-poslug-dostavki.md).

# Оплата послуг доставки

## Оплата послуг доставки через API Nova Post

API Nova Post дозволяє налаштувати готівкові та безготівкові платежі за послуги доставки. Процес оплати можна налаштувати під різноманітні випадки, адже методи оплати забезпечують можливість оплати з боку відправника, отримувача або третьої особи.

### Методи оплати за послуги доставки

{% hint style="info" %}
API підтримує три основних типи платників послуг доставки: відправник, одержувач, третя особа.
{% endhint %}

| Оплата відправником                                                                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Можливі способи оплати залежать від статуса клієнта, якщо відправник:</p><ul><li>Приватна особа: оплата здійснюється онлайн через застосунок, готівкою або карткою при передачі відправлення в Nova Post.</li><li>Бізнес-клієнт, що має договір з Nova Post: безготівкова оплата за умовами договору з Nova Post або готівкою/карткою при передачі відправлення.</li></ul><p>Доступно за всіма напрямками доставки.</p> |

| Оплата одержувачем:  Доступність послуги залежить від напрямку доставки                                                                                                                                                                                                                 |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <ul><li>З України → в країну присутності. Одержувач оплачує вартість доставки онлайн через застосунок до отримання посилки або  при отриманні відправлення готівкою або картою у відділенні.</li><li>З країни присутності → в Україну / між країнами присутності. В розробці.</li></ul> |

| Оплата третьою особою                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Платник послуги – юридична особа, яка має контракт з NovaPost, відповідні дозволи на сплату послуг як третя особа та не є при цьому ані відправником, ані одержувачем.</p><p>Третя особа може бути вказана як платник або самою компанією, яка створює відправлення для своїх клієнтів, або клієнтами, що мають відповідну домовленість про сплату з цією юридичною особою. Послуга зручна для корпоративних клієнтів, партнерів або маркетплейсів, які бажають покривати витрати на доставку для своїх клієнтів або партнерів.</p><p>Для підключення цієї можливості клієнтам необхідно звернутися до свого менеджера в NovaPost.</p> |

### Опис полів для налаштування методу оплати

<mark style="color:$success;">**`payerType`**</mark> визначає, хто відповідальний за оплату послуг доставки. Можливі значення:

* <mark style="color:$success;">`Sender:`</mark> Відправник оплачує доставку
* <mark style="color:$success;">`Recipient:`</mark> Отримувач оплачує доставку
* <mark style="color:$success;">`ThirdPerson:`</mark> Оплату здійснює третя сторона\
  \
  При виборі цього варіанту потрібно заповнити поле payerContractNumber.

payerContractNumber: є обов'язковим:

* коли обрано <mark style="color:$success;">`ThirdPerson`</mark> як тип платника. Воно має містити номер контракту платника. Для клієнтів з України можна вказати ідентифікаційний код (ЄДРПОУ) замість номера контракту.
* коли обрано <mark style="color:$success;">`Sender`</mark>/<mark style="color:$success;">`Recipient`</mark> як тип платника і використовується безготівковий спосіб оплати. Якщо ця інформація не буде надана, оплата автоматично перемикається на готівкову.

Забезпечте коректність введеної інформації, оскільки вона є важливою для правильного оброблення платежу. Це дозволить вам успішно інтегрувати оплату третьою особою у ваші API-запити та забезпечити гнучкість при здійсненні оплат за доставку.

{% hint style="info" %}
Детальні описи цих полів доступні на наступній сторінці: [API Docs](/metodi-1/metodi/readme/vidpravlennya.md) → Shipments → Body
{% endhint %}

<figure><img src="/files/CyoqKTFXuAVlM2eF0ug5" alt=""><figcaption></figcaption></figure>

Кроки для доступу до документації API [на порталі з документацією](https://api.novapost.com/developers/index.html#post-/shipments): Створення відправлень → Shipment → Create documents.

### Приклади запитів

<details>

<summary>Приклад запиту для оплати відправником</summary>

```
{
  "status": "ReadyToShip",
  "clientOrder": "1234567890",
  "note": "Documents shipment",
  "payerType": "Sender",               // Платником виступає відправник
  "payerContractNumber": "123456789",  // Контрактний номер відправника для безготівкової оплати
  "invoice": {
    "incoterm": "DAP",
    "currencyCode": "EUR",
    "totalCost": 500.00
  }
}
```

Опис полів:

* <mark style="color:$success;">payerType: "Sender"</mark> — визначає, що платником є відправник
* <mark style="color:$success;">payerContractNumber</mark> — контрактний номер відправника для безготівкової оплати
* invoice —  об'єкт, що містить деталі інвойсу, включаючи incoterm та валюту

</details>

<details>

<summary>Приклад запиту для оплати отримувачем</summary>

```
{
  "status": "ReadyToShip",
  "clientOrder": "0987654321",
  "note": "Books delivery",
  "payerType": "Recipient",            // Платником виступає отримувач
  "invoice": {
    "incoterm": "DAP",
    "currencyCode": "USD",
    "totalCost": 300.00
  }
}
```

Опис полів:

* <mark style="color:$success;">payerType: "Recipient"</mark> — визначає, що платником є отримувач
* <mark style="color:$success;">invoice</mark> — об'єкт, що містить деталі інвойсу для митного оформлення.

</details>

<details>

<summary>Приклад запиту для оплати третьою особою</summary>

```
{
  "status": "ReadyToShip",
  "clientOrder": "1122334455",
  "note": "Electronics shipment",
  "payerType": "ThirdPerson",          // Платником виступає третя особа
  "payerContractNumber": "987654321",  // Номер контракту третьої особи для безготівкової оплати
  "invoice": {
    "incoterm": "DAP",
    "currencyCode": "EUR",
    "totalCost": 1000.00
  }
}
```

Опис полів:

* <mark style="color:$success;">payerType: "ThirdPerson"</mark> — визначає, що платником є третя особа.
* <mark style="color:$success;">payerContractNumber</mark> —  номер контракту третьої особи, яка здійснюватиме оплату.\
  \
  Це поле є обов'язковим, коли обрано ThirdPerson як тип платника. Воно має містити номер контракту платника. Для клієнтів з України можна вказати ідентифікаційний код (ЄДРПОУ) замість номера контракту.

</details>

{% hint style="info" %}
Деталі щодо кожного з параметрів та додаткових можливостей можна знайти [у документації API](https://api.novapost.com/developers/index.html#post-/shipments).

Інтегруйте функції оплати у свої системи та надайте клієнтам комфортний сервіс.
{% endhint %}


---

# 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:

```
GET https://api-portal.novapost.com/metodi-1/metodi/readme/oplata-poslug-dostavki.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.