Documentation

Mapping to an External Coupon

Suggest Edits

ACP platform enables brands to create coupons in external CRM systems & run them on the online storefront. By doing so, you can give consistent offline and online experience to your customers. They can apply the same promotion in both places.

For example, as a part of the Birthday campaign , you can plan a campaign that offers 25% discount upto INR 2000/- for one time use to users during their birthday month. By having an external promotion configured, you can ensure that this voucher can be used on both online and offline channels, once on either channel.

There are a number of places where you can show external coupons such as, cart page or product pages.

📘

The internal and external coupons will be displayed to end-users through a popup, upon clicking the Apply Coupons button in the Cart Page itself.

Setting up external coupon

Setting up external coupon consists of three steps:

  1. Add the API URL and it’s credential for the brand on the tblvouchervalidatoraddonsetup table.

For this you need to raise a ticket with the Sustenance team.

📘

Following is the sample data that needs to be added:

API Password: 0b1dd5fabd221ef63c58c026bce4cf6b

API UserName: indianterrain.ecom

URL_GetCouponCode: http://api.capillary.co.in/v1.1/coupon/get.json?id={0}&code={1}

URL_IsRedeemable: http://api.capillary.co.in/v1.1/coupon/isredeemable.json?mobile={0}&email={1}&external_id={2}&code={3}&details={4}

URL_RedeemCoupon: http://api.capillary.co.in/v1.1/coupon/redeem?format=json

UseLocRefCode: False

  1. Setting up External coupon settings.

  2. Creating External coupons in Cart Promotions tab.

Setting up External Coupon Settings

Before jumping into the External coupon settings, let’s discuss the anatomy of any promotion. Typically, the cart promotions consists of two parts:

  • Validation conditions - Conditions that need to be satisfied by the cart for the promotion or voucher to be applicable.
    These are the Conditions that brands configure in the Conditions tab and the user-specific usage conditions comprise of this.

  • Discount processing logic - The logic that calculates the discount amount upon voucher application.
    These are the Actions & Actions condition section takes care processing part in ACP.

How validation & processing works on ACP?

  • On application of any coupon, first the promotion conditions for all active promotions are checked. All those promotions where the promotion conditions are satisfied are considered for the next step.

  • For each such promotion, validator runs and checks the following:

  1. Does the coupon correspond to this particular promotion series?
  2. Is the promotion valid?
  3. Is the coupon user specific and if it is, is it applicable for this user or not?

Setting up preference order in Marketing> External coupon settings determines - which one we would apply first.
Next comes the processor logic - which calculates the discount value of the promotion.
Setting up preference order in Marketing> External coupon settings determines - which processor would be applied first.

Configuring validators & processor for external promotions

To create an external coupon, navigate to Marketing > External Coupon Settings.

Here, you will find a list of existing coupons. You can either delete any of these or click on Add New to create a new coupon.

After clicking on Add New, a window will appear. You will find and option of selecting your desired processor from the list of three given processors named:

  • Capillary External Voucher Processor
  • Asics Voucher Processor
  • Levis Voucher Processor

Creating external coupons in Cart promotions

After logging in to ACP, click on Marketing > Manage Promotions > Cart Promotions. Follow the general process of adding a new cart promotion.

Navigate to Rule Information.

Select Yes from the drop down of Enable Discount Voucher Campaign? as well as from the drop-down of Is Mapped To External Coupon System? .

Now, enter the reference code given by the external coupons provider in the Rule Ref Code. For Capillary CRM based external coupons, you need to enter the coupon series ID here.

📘

For external coupons you don’t have to create any voucher code in the ACP system. Upon application of a CRM voucher code; the system would follow the steps mentioned in How validation & processing works on ACP?

External voucher visibility

After following the other procedures of a cart promotion, when the user clicks on Apply Offers in the cart page of your app or website.

Case 1: If The User Is Not Logged In

The internal vouchers that are created against a cart promotion will be displayed.

Case 2: If The User Is Already Logged In

Both the internal and external coupons will be displayed.

Checkout how you can give visibility to External vouchers here.

Updated almost 2 years ago