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

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

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

Доступні напрямки:

  • 1
    Польща → Україна
  • 2
    Румунія → Молдова*
    * в тестовому режимі

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

Доступні способи оплати для відправлень:

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

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

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

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

    Параметри оплати включають вибір валюти, що зазначено у договорі, автоматичну конвертацію, спосіб оплати (готівка або банківський переказ), платника за комісію за надання послуги 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

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

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

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

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

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

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

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