Payment on Delivery

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

International directions:

• Poland, Czech Republic, Germany, Slovakia → Ukraine

• Romania → Moldova* * In testing mode

Domestic shipments within these countries:

• Czech Republic, Poland, Germany

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:

• Poland, Czech Republic, Germany → Ukraine: only online via the Nova Post mobile app or via the link

• Local shipments within the Czech Republic, Poland, and Germany: only online via the app

• From Romania to Moldova*: Cash, card, or bank transfer, and online via the Nova Post mobile app.

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

• The recipient pays for the parcel upon receipt and has the option to inspect the goods before making the payment.

• 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, and the party responsible for covering the COD service fee.

The payer of the service fee is specified in the contract for all parcels:

• Sender

• Recipient

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

• serviceCode: "COD" — the code indicating the Cash on Delivery (COD) service.

• amount — the total amount the recipient must pay under the COD service.

• payerType: "Recipient" — defines the payer for the service; in this case, it's the recipient.

• additionalParameters — additional parameters for configuring COD:

  • bankAccount.amount — the amount that will be transferred to the sender’s account after payment.

  • bankAccount.currencyCode — the currency for the transaction, defined by the sender’s contract.

  • bankAccount.bankAccountId and bankAccount.bankAccountName — unique identifiers of the account and its name where the transfer will be made.

  • bankAccount.commissionPayer — specifies the recipient as the payer of the service commission.

Parameter Logic

• Amount: Specifies the amount the recipient must pay upon receipt. Automatic currency conversion is possible depending on the sender's or recipient's country.

• Currency: By default, the currency of the sender’s country is used, but it is possible to set the currency manually*.

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.