Eng
Payment on Delivery
integration

The Cash on Delivery (COD) service allows the recipient to pay for the goods directly upon receiving them, without the need for prepayment. The sender can add this service to the shipment, and the recipient has the option to pay upon delivery, taking into account the payment method restrictions set for specific countries.

Geographical Restrictions

Available directions:

  • 1
    Poland → Ukraine
  • 2
    Romania → Moldova*
    * In testing mode

The service is planned to expand to other countries and delivery directions in the future, both for international shipments and within European countries.

Available Payment Methods for Shipments:

  • 1
    From Poland to Ukraine: Online only, via the Nova Post mobile app.
  • 2
    From Romania to Moldova*: Cash, card, or bank transfer, and online via the Nova Post mobile app.

    * In testing mode

Key Features of the Cash on Delivery (COD) Service:

  • 1
    The recipient pays for the parcel upon receipt and has the option to inspect the goods before making the payment.
  • 2
    The sender can set the payment parameters for the COD service.

    Payment parameters include the choice of currency, as specified in the contract, automatic conversion, payment method (cash or bank transfer), and the party responsible for covering the COD service fee.

Integration of Cash on Delivery (COD) Service via API

To integrate the COD service through the API, you need to use the "services" block, which contains information about the additional services for the shipment. Below is an example of the settings for COD.

  • Example:

    "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"
            }
          }
        }
      }
    ]

Description of Fields in the Services Block

  • 1
    serviceCode: "COD" — the code indicating the Cash on Delivery (COD) service.
  • 2
    amount — the total amount the recipient must pay under the COD service.
  • 3
    payerType: "Recipient" — defines the payer for the service; in this case, it's the recipient.
  • 4
    additionalParameters — additional parameters for configuring COD:
    • 4.1
      bankAccount.amount — the amount that will be transferred to the sender’s account after payment.
    • 4.2
      bankAccount.currencyCode — the currency for the transaction, defined by the sender’s contract.
    • 4.3
      bankAccount.bankAccountId and bankAccount.bankAccountName — unique identifiers of the account and its name where the transfer will be made.
    • 4.4
      bankAccount.commissionPayer — specifies the recipient as the payer of the service commission.

Parameter Logic

  • 1
    Amount: Specifies the amount the recipient must pay upon receipt. Automatic currency conversion is possible depending on the sender's or recipient's country.
  • 2
    Currency: By default, the currency of the sender’s country is used, but it is possible to set the currency manually*.

    * Feature under development

Advantages and Limitations

  • Currency is defined by the contract
    The typical setup is to use the sender’s country currency, but the recipient’s currency can be specified, provided it is included in the contract.
  • Manual correction
    If you want to avoid automatic conversion, the API allows you to specify the recipient’s currency manually.*
  • Flexible payment parameters
    The API allows configuring payment parameters, including selecting the payment method and setting the amount.
  • Shipment blocking
    The shipment release is blocked until payment is made, but the recipient can inspect the goods before making the payment.

*Feature under development