POS - Payments, Taxes, Discount & other Charges

Payment Types

The payment types are as follow:

Payment Type	Integer Value
Credit Card Online	0
Cash	1
On Delivery	2
Online	3
Credit Card at Door	4
PIN at Door	5
Voucher at Door	6
Meal Voucher	7
Bank Contact	8
Other	9

Tax Exclusive Orders

If the merchant account is operating in a tax exclusive region, we will configure this setting in Deliverect. You will then receive the payment amount including the taxes with a parameter "taxTotal" showing the combined total for all taxes applied

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

Attribute	Meaning	Type
`taxTotal`	This is combined total of all taxes applied to the order	integer
`taxRemitted`	In regions where the channel has responsibility for charging tax e.g. where they are 'Marketplace Facilitator' this is the total tax remitted	integer
taxes.`name`	An optional value for channels to provide to specific the name for each tax applied	string
taxes.`taxClassId`	An optional value for channels to provide to an Id to identify the tax applied	integer
taxes.`total`	An optional value for channels to provide to the total specific to the tax applied	integer

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 (see full Order Model here)

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.

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.د.ب

ⓘ Relevant Only in 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