How to set up rewards and vouchers for Orderbilly

Once the Orderbilly integration is active, you decide on each reward and voucher how it works in Orderbilly: as a free product or as a discount. You do this with the Orderbilly fields on the reward, or on the promotion for a voucher. To install the integration first, see How to set up an Orderbilly integration.

Where to find the Orderbilly fields

For a reward, go to Loyalty → Rewards and open it. For a voucher, go to Loyalty → Promotions & Vouchers and open its promotion.
Click Discount logic in the menu on the left. The Orderbilly fields are in their own section there.

If your Orderbilly fields aren't grouped under the integration's name, you'll find them under Custom attributes on a reward, and under Details on a promotion instead.

The fields

orderbilly_reward_type: Product or Discount. Whether the contact gets a product for free or a discount.
orderbilly_reward_products: the menu products the reward gives.
orderbilly_product_amount: how many products are rewarded.
orderbilly_discount_type: Percentage or Amount. Whether the discount is a percentage or a fixed amount.
orderbilly_discount_amount: the value of the discount. Together with orderbilly_discount_type, this sets how much is taken off.
orderbilly_includes_paid_additions: on or off. Turn it on if the reward should also cover paid additions. Leave it off to keep paid additions paid.
orderbilly_required_on_menu: on or off. When it's on, only products that are on the menu are shown.
orderbilly_dependent_products: a product that has to be in the cart before the contact gets the products under orderbilly_reward_products for free.
orderbilly_dependent_product_amount: how many of the dependent products have to be in the cart.

A free product

For example, a free soft drink:

orderbilly_reward_type: Product
orderbilly_reward_products: the soft drinks the contact can choose from
orderbilly_product_amount: 1, so only 1 item is rewarded
orderbilly_discount_type: Percentage
orderbilly_discount_amount: 100
orderbilly_required_on_menu: on

A percentage discount

For example, 5% off:

orderbilly_reward_type: Discount
orderbilly_discount_type: Percentage
orderbilly_discount_amount: 5

A fixed discount

For example, €10 off:

orderbilly_reward_type: Discount
orderbilly_discount_type: Amount
orderbilly_discount_amount: 10