Not logged in - Login

Confirming Baskets

Go to Promo Help Home

Overview

When baskets are validated by Promo, the engine will utilize or issue Campaign/Coupon codes where they are utilized or issued by promotions applied to the basket. In some cases, baskets can be submitted multiple times while a sale is being created, and in these cases it may be required to ensure that a code is not marked as utilized or issued until the sale is confirmed. To help with this situation, baskets submitted to promo can provide a confirmed flag to tell the Promo engine whether the basket being validated is a confirmed sale, and therefore whether any codes that have been utilized or issued by promotions applied to the basket should be committed.



A basket is regarded as having been submitted multiple times when it has the same basket reference assigned to it. When reviewing historic baskets submitted to the engine, it is possible to view all previous submissions for a basket.

For further details on viewing historic baskets, please click here.

Confirm Baskets Setting

To indicate to Promo whether baskets will require confirmation, the company setting Require baskets to be confirmed should be configured with a value of true.

Where this setting has value of true each basket should be submitted with a flag indicating whether the basket is confirmed. If the flag is not supplied, Promo will assume that the confirmed flag has a value of false for the basket. If a value of true is supplied with a basket, Promo will confirm any codes which have been issued or utilized.

Baskets submitted via services

When baskets are submitted for validating via the services, and where the company setting Require baskets to be confirmed is configured with a value of true, each basket should provide a confirmed flag with the basket, with a value of true or false. When codes are issued or utilized, a flag is provided in the basket validation response to indicate whether the issuing or utilization has been confirmed, and these additional flags should be used to determine what action to be taken (i.e. whether to provide feedback to the end user on the issuance or utilization of the code).

For web integrations, it is recommended that each basket submitted to Promo for validation should have a confirmed flag value of false, until the end user has gone through the checkout process and the order has been confirmed, and the basket should then be re-submitted to Promo again (ensuring the basket sale date is identical to any previous submissions) with the confirmed flag set with a value of true.

Baskets submitted via the Promo Administration Portal

Where the Require baskets to be confirmed company setting is configured with a value of true, the Promo Basket Builder will provide all baskets with a confirmed flag of false. If required, the Promo Basket Builder can be configured to allow a value of true to be supplied. To allow the option to be specified, the company setting Confirm Use from Basket Builder should be configured with a value of true. Where this setting has value of true, a flag will be presented on the Options tab of the Basket Builder called Confirm Basket?. Ticking the option will provide baskets with a confirmed flag value of true.