Overview

We use the term order to refer to an order in the merchant's order system. At Paynova, an order is an entity which encapsulates all invoice-related information around a merchant's order. Before a payment can be made, an order must be created by using the Create Order service.
There are two levels of orders which we use, the first is a simple order and the second is a detailed order. The difference being that simple orders involve much less information and are easier to work with, however they do not have support for all available functions and payment methods. Information on which payment methods support simple orders is found on the Payment Method overview.

Simple Orders

Simple orders consist of the following basic information:

  • Amount
  • Currency Code
  • Order Number

Simple orders are only recommended when you will only be using payment methods such as cards and most internet banks. It is important to note that if you would like to use a payment method in the future which requires detailed order information, then you will need to perform an upgrade of your integration.

Detailed Orders

📘

Invoice as a service

Detailed orders are required for invoice as a service

When a order contains full order line information (the order basket) it is called a detailed order.

Although not all other information (parameters) is required, we strongly recommend that you provide as much information as possible to fully support all payment methods, current and future.

Detailed orders also allow us to provide more information to risk analysis (fraud screening) systems which in turn will result in more accurate risk decisions - less declines of valid orders and reduced acceptance of fraudulent orders.

Operations on detailed orders require line items (full order line information) unless working with full order amounts since then the line items provided in the original create order operation can be used.

Payments

An order can have multiple payments, and each payment can have multiple finalizations and refunds. Depending on the Payment Method used in the payment, there may be some restrictions on how many finalizations/refunds may be performed on the payment.