Skip to main content

Handling Discounts

Here are some recommendations on how to apply discounts to the Customer's order.

OptionsDescriptionInstructionsOutcomes
1Discounts are split across line items (preferred)Spread the discount across all line items (order lines).

The top level amount is the nett amount after discount.

The top level amount matches the sum of the line items.
Individual line items are processed by Latitude systems.

Merchant Portal will show individual line items.

- For Merchants with Deferred settlement, individual line items provide the ability to perform partial void, partial capture, partial refund. The partial amount is the discounted amount.

- For Merchants with Instant settlement, no impact. Partial refunds can still be done.
2Total Discount applied to one line itemApply the total discount to a single line item (single order line).

The remaining line items will not have the discount.

The top level amount matches the sum of the line items.
Individual line items are processed by Latitude systems.

Merchant Portal will show individual line items.

- For Merchants with Deferred settlement, individual line items provide the ability to perform partial void, partial capture, partial refund. The partial amount is the discounted amount. If the returned product contains the discount, then the Customer will miss out on discount (to avoid this, you can perform a full refund (of the whole order) and create a new order with the discount applied).

- For Merchants with Instant settlement, partial refunds can still be done. If the returned product contains the discount, then the Customer will miss out on discount (to avoid this, you can perform a full refund (of the whole order) and create a new order with the discount applied.
3aDiscount shown as line item with negative amount.

Other orderLines are full price.
The top level amount is the nett amount after discount. (eg. 450)

The line item (order line) will show the full price (gross). (eg. 2 line items, 200 and 300)

There will be a separate line item to reflect the discount, with a negative amount. (eg. -50)
Latitude Checkout will aggregate individual line items into a single line item. Latitude does not know which items qualify for discount, nor how much.

Merchant Portal will show only 1 line item, with the nett (top level) amount.

- For Merchants with Deferred settlement, since Latitude treats this as a single line item, partial API voids and partial API captures cannot be done. Partial refund is fine.

Merchants can use Merchant Portal to manually split the single line item into 2 or more line items.

- For Merchants with Instant settlement, no impact. Partial refunds can still be done.
3bDiscount shown as line item with negative amount

Other orderLines contain discount.
The top level amount is the nett amount after discount. (eg. 450)

The line item (order line) will show the nett amount after discount. (eg. 10% discount, 2 line items, 180 and 270)

There will be a separate line item to reflect the discount, with a negative amount. (eg. -50)

same as 3a
4GiftcardsGiftcards or any other adjustment can be sent as line items (order lines), similar to option 3.

Use the "name" to specify what type of adjustment has been applied.

eg. "name": "giftcard payment" or "name": "adjustment" or "name": "voucher

The field totalDiscountAmount can be used if your platform requires it, however Latitude does not use this field to calculate the total amount.
same as 3a or 3b

example of Discount shown as line item with negative mount

"orderLines": [
{
"type": "product",
"name": "applied discount",
"productUrl": "",
"sku": "",
"quantity": 1,
"unitPrice": -50,
"amount": -50,
"tax": 0,
"requiresShipping": false,
"isGiftCard": false
}