Укр
Оплата при отриманні
integration
Методи

Оплата послуг та товарів

Послуга «Оплата при отриманні» або COD (Cash on Delivery) дозволяє оплатити товар безпосередньо при отриманні без потреби здійснювати передоплату. Відправник може додати цей сервіс до відправлення, а одержувач має можливість оплатити товар при отриманні з урахуванням обмежень щодо способу оплати, встановлених для конкретних країн.

Географічні обмеження

Міжнародні напрямки:

  • Польща, Чехія, Німеччина → Україна
  • Румунія → Молдова*
    * в тестовому режимі

Локальні відправки у межах таких країн:

  • Чехія, Польща, Німеччина

В майбутньому планується поширення послуги на інші країни та напрямки доставки: як для відправлень між країнами, так і для внутрішніх у межах Європи.

Доступні способи оплати:

  • Польща, Чехія, Німеччина → Україна: тільки онлайн за допомогою мобільного застосунку Nova Post або за посиланням
  • локальні відправки у межах Чехії, Польщі та Німеччини: тільки онлайн в застосунку
  • з Румунії в Молдову*: готівкою, карткою або через банківський рахунок, онлайн за допомогою мобільного застосунку Nova Post

    * в тестовому режимі

Платник комісії за послугу фіксується в договорі для всіх посилок:

  • Відправник
  • Одержувач

Основні особливості послуги «Оплата при отриманні»:

  • Одержувач сплачує вартість посилки при отриманні та має можливість оглянути товар перед оплатою.
  • Відправник може задавати параметри оплати при отриманні.

    Параметри оплати включають вибір валюти, що зазначено у договорі, автоматичну конвертацію, платника за комісію за надання послуги COD.

Інтеграція послуги «Оплата при отриманні» (COD) за допомогою API

Для інтеграції послуги через API необхідно використовувати блок "services", що містить інформацію про супутні послуги відправлення. Нижче наведено приклад налаштувань для COD.

  • Приклад:

    "services": [
      {
        "shipmentParcelRowNumber": null,
        "serviceCode": "COD",
        "amount": 10,
        "contractNumber": null,
        "payerType": "Recipient",
        "additionalParameters": {
          "cod": {
            "cash": null,
            "card": null,
            "bankAccount": {
              "amount": 10,
              "currencyCode": "PLN",
              "bankAccountId": "1234567890",
              "bankAccountName": "PL12345678901234567890123456",
              "description": "test S",
              "commissionPayer": "Recipient"
            }
          }
        }
      }
    ]

Опис полів блоку services

  • serviceCode: "COD" — код сервісу, що вказує на наявність послуги «Оплата при отриманні».
  • amount — загальна сума, яку одержувач має сплатити в межах послуги COD.
  • payerType: "Recipient" — визначає платника послуги, у прикладі це одержувач.
  • additionalParameters — додаткові параметри для налаштування COD:
    • bankAccount.amount — сума, яка буде надіслана на рахунок відправника після оплати.
    • bankAccount.currencyCode — валюта транзакції. Визначається за договором відправника.
    • bankAccount.bankAccountId та bankAccount.bankAccountName — унікальні ідентифікатори рахунку та його ім'я, на який буде здійснено переказ.
    • bankAccount.commissionPayer — визначає одержувача як платника комісії за сервіс.

Логіка роботи параметрів

  • Сума: вказується сума, яку одержувач має сплатити при отриманні. Можлива автоматична конвертація валюти залежно від країни відправника або одержувача.
  • Валюта: за замовчуванням використовується валюта країни відправника, проте є можливість задати валюту вручну*.

    * функція у розробці

Переваги та обмеження

  • Валюта визначається договором
    Типовим є використання валюти країни відправника, однак можна вказати валюту отримувача, але вона повинна бути вказана у договорі.
  • Ручна корекція
    Якщо потрібно уникнути автоматичної конвертації, API дозволяє вказати валюту отримувача вручну*
  • Гнучкі параметри оплати
    API дозволяє налаштовувати параметри платежу, включаючи вибір способу оплати та налаштування суми.
  • Блокування видачі
    Видача відправлення блокується до моменту оплати, але оглянути товар можна перед його оплатою.

*функція у розробці