Skip to main content
A voucher that only works in the app is an incentive to install it. It is suitable for campaigns meant to bring customers from the browser into the app, and for promotions you want to reserve exclusively for app users. This restriction is purely a property of the voucher. Nothing needs to be set up in the shop apart from the corresponding error message.

​
How the shop recognizes the app

The shop checks whether the request includes an app version. Only then is the session considered an app session.
A customer who opens the shop in the browser on their phone is therefore not an app user, even if the page looks mobile there. The voucher is rejected. Word the advertising for such a promotion unambiguously, otherwise the questions will end up with your support team.

​
Prerequisite

The voucher generator must be activated. Contact your WEBSALE representative to arrange this.
If the vouchers come from an external system and are therefore not in WEBSALE format, add the entry ExternalVouchers-Allow = yes in the <Voucher-Txt> section of the shop.config.
Guide: Providing voucher entry · Reference: Voucher-Txt section

​
Step 1: Restrict the voucher

When creating the voucher in the voucher generator, enter the following string in the Kundenspezifische Features (custom features) field at the very bottom.
This function has no further settings. It is either set or not.

​
Step 2: Add the error message

If the voucher is entered outside the app, the shop rejects it with reason 24. Add this reason wherever you have integrated the voucher entry, i.e. on the basket page ws_basket.htm or the order overview page ws_place_order.htm.
Without this text, the customer sees an empty message. They have a valid code in hand, it is not accepted, and they do not find out why. Of all the rejection reasons, this is the most frustrating one, because the customer did everything right.
A link or a reference to the app store in the message text turns the rejection into an invitation. That is exactly what this type of voucher is intended for.
Reference: MSG-Voucher_error

​
Step 3: Point out the restriction (optional)

If the data of a voucher is available, its restriction can be displayed.
The section refers to the currently loaded voucher data, i.e. to an entered voucher or to one you have loaded with VOUCHER-LoadData.
In addition, you can use WS-AppVersion to query whether the visitor is using the app at all, and show the reference to the app right away on a promotion page in the browser instead of only at the point of rejection.
Reference: VOUCHER-SpecialFeatures_ValidOnlyForApp · VOUCHER-LoadData · WS-AppVersion
  • Guide: Offering vouchers: Overview
  • Guide: Creating or importing vouchers
  • Guide: Providing voucher entry