POS - Payments, Taxes, Discount & other Charges

Payment Types

The payment types are as follow:

Decimal Digits

Each order will specify the decimal precision with the "decimalDigits" attribute. In world currency, there is really only two formats to expect;

Two Decimal Digits

Most typically, orders will sent with payment amounts expressed in two decimal digits i.e. "decimalDigits": 2
For example, a channel could send an order with an "amount": 1050, which would equate to a transaction value of $10.50

Three Decimal Digits

In certain countries such as; Jordan, Kuwait, Oman and Bahrain, channels will process orders with prices expressed in three decimal digits i.e. "decimalDigits": 3
For example, a channel could send an order with an "amount": 1050, which would equate to a transaction value of 1.050.د.ب

❗️

Limited to Certain Regions

Please note that not all the channels operating in regions where 3 decimal digits apply will send amounts in this format to Deliverect, in this cases a POS should expect "decimalDigits": 2

Tax Identification Number

It is possible to receive the customer tax identification number as tin inside the "customer" object given that it is provided by the channel.

Tax Exclusive Orders

If the merchant account is tax exclusive, we will configure this setting in Deliverect. You will receive the payment amount including the taxes. Additionally, we will send you the parameter "taxTotal" with the total amount for taxes alongside a tax array with more specific information about the tax amount. The information inside the array comes from the channels.

"taxes": [
    {
      "name": "taxes",
      "taxClassId": 0,
      "total": 51
    }
  ],
  "taxTotal": 51

Discounts

You can see the total amount to be discounted under "discountTotal" parameter. This is a flat amount reduced from the total payment amount of the order. If the channel has provided us with extra discount information, you will then have an additional "discounts" object in the payload. You can find the explanation of the parameters included in that object in the Glossary - POS Orders. Note, that the amount of discountTotal is what you need to display. The rest of the information is for reporting purposes.

You can find a guide on how we send discounts here.