pw/Create Welcome-to-Voucherify.md

Changelog.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 20231027 - Welcome to Voucherify, Stackable Discounts
+
+- Added new article "Welcome to Voucherify" in "Getting started"
+- Updated the "Stackable discounts API" article – current redeemable limit is 30, not 5
 
 ## 20231025 - Rewards, Loyalties
 

docs/guides/discounts_recipes/Stackable-Discounts-API.md

@@ -8,7 +8,7 @@ hidden: false
 order: 1
 ---
 
-Voucherify API for stackable discounts lets you validate and redeem up to 5 objects using a single API request. You can combine coupons, gift cards, promotion tiers, loyalty, and referral codes. 
+Voucherify API for stackable discounts lets you validate and redeem up to 30 objects using a single API request. You can combine coupons, gift cards, promotion tiers, loyalty, and referral codes. 
 
 In the redemption request, you need to provide a list of redeemables that define what discounts or codes will be redeemed/validated. 
 
@@ -19,13 +19,13 @@ In the redemption request, you need to provide a list of redeemables that define
 | **The workflow** | **API Endpoint** |
 |---|---|
 | VALIDATION<br>Validation checks if all redeemables provided in the request can be applied in the given context (checks customer and order details against validation rules and other attached limits). Only if all redeemables can be applied, the validation returns `valid: true`. | **POST** `base_URL/v1/validations` _for server-side_<br>**POST** `base_URL/client/v1/validations` _for client-side_ |
-| REDEMPTION<br>You can pass up to 5 redeemables that will be redeemed during the request. Only if all redeemables can be applied (each redeemable is validated before the redemption), the redemption is successful. | **POST** `base_URL/v1/redemptions` _for server-side_<br>**POST** `base_URL/client/v1/redemptions` _for client-side_ |
+| REDEMPTION<br>You can pass up to 30 redeemables that will be redeemed during the request. Only if all redeemables can be applied (each redeemable is validated before the redemption), the redemption is successful. | **POST** `base_URL/v1/redemptions` _for server-side_<br>**POST** `base_URL/client/v1/redemptions` _for client-side_ |
 | ROLLBACK<br>In the case of unwanted redemption, you can roll it back. Note that if you call this endpoint, all applied discounts will be rolled back too. There is no way to roll back a redemption of a single redeemable. | **POST** `base_URL/redemptions/parent_redemption_id/rollbacks` |
 
 ## Redeemables reference
 
-Redeemables array can gather up to 5 objects. Each element represents an object that will be validated/redeemed when calling the API. In the reference below, you can learn how to pass each type of redeemable in the payload.
-**Redeemables array can gather up to 5 objects or 1 promotion stack with 5 tiers included.** Each array element represents an object that will be redeemed when calling the API. In the reference below, you can learn how to pass each type of redeemable in the payload.
+Redeemables array can gather up to 30 objects. Each element represents an object that will be validated/redeemed when calling the API. In the reference below, you can learn how to pass each type of redeemable in the payload.
+**Redeemables array can gather up to 30 objects or 1 promotion stack with 5 tiers included.** Each array element represents an object that will be redeemed when calling the API. In the reference below, you can learn how to pass each type of redeemable in the payload.
 
 | Redeemable type | Payload | Reference |
 |---|---|---|
@@ -196,7 +196,7 @@ POST https://URL/v1/validations
 
 ## Redemption
 
-You can pass up to 5 redeemables that will be redeemed during the request. Only if all redeemables can be redeemed (each redeemable is validated before the redemption), the redemption is successful.
+You can pass up to 30 redeemables that will be redeemed during the request. Only if all redeemables can be redeemed (each redeemable is validated before the redemption), the redemption is successful.
 
 POST https://URL/v1/redemptions 
 

docs/guides/getting_started/API-Endpoints.md

@@ -5,7 +5,7 @@ categorySlug: getting-started
 slug: api-endpoints
 type: basic
 hidden: false
-order: 6
+order: 7
 ---
 
 Voucherify is shipped from shared clusters located on three continents, as well as from dedicated clusters for enterprise customers.

docs/guides/getting_started/Authentication.md

@@ -5,7 +5,7 @@ categorySlug: getting-started
 slug: authentication
 type: basic
 hidden: false
-order: 5
+order: 6
 ---
 
 ## Authorization overview

docs/guides/getting_started/Integration-Checklist.md

@@ -5,7 +5,7 @@ categorySlug: getting-started
 slug: welcome
 type: basic
 hidden: false
-order: 3
+order: 4
 ---
 
 Voucherify makes launching and tracking digital promotions easy. Get the documentation, sample code, and developer tools you need to build exactly what you want, fast. We will handle the complexity of promotions delivery and validation. Let’s get building!

docs/guides/getting_started/Key-Concepts.md

@@ -5,7 +5,7 @@ categorySlug: getting-started
 slug: key-concepts
 type: basic
 hidden: false
-order: 4
+order: 5
 ---
 
 Voucherify splits each campaign into 5 stages:

docs/guides/getting_started/Quickstart.md

@@ -5,7 +5,7 @@ categorySlug: getting-started
 slug: quickstart
 type: basic
 hidden: false
-order: 2
+order: 3
 ---
 
 Welcome to Voucherify! We’re excited to be your partner in building a future-proof Promotion Engine. Let’s start with a simple use case — applying a $10 off BLCKFRDY coupon to the cart — to learn how Voucherify works.

docs/guides/getting_started/Welcome-to-Voucherify.md

@@ -0,0 +1,133 @@
+---
+title: Welcome to Voucherify
+excerpt: 
+categorySlug: getting-started
+slug: welcome-to-voucherify
+type: basic
+hidden: false
+order: 2
+---
+
+## Platform overview
+
+Voucherify is an API-first Promotions and Loyalty Engine that helps brands run personalized [coupons](https://www.voucherify.io/coupon-software "Voucherify coupon software"), [gift cards](https://www.voucherify.io/gift-cards "Voucherify gift cards"), [auto-applied promotions](https://www.voucherify.io/discount-promotions "Voucherify discount promotions"), [loyalty programs](https://www.voucherify.io/loyalty-software "Voucherify loyalty programs"), and [referral campaigns](https://www.voucherify.io/referral-programs "Voucherify referral programs"). 
+
+Voucherify gives you access to a collection of promotion & loyalty **REST API endpoints** and **a visual Dashboard**. 
+
+Every integration is unique – however, at its core, the integration of Voucherify with your system relies on **passing relevant context to Voucherify API**, which validates and redeems incentives and rewards in accordance with the rules you set up with the Rules Engine.
+
+As a [MACH-certified vendor](https://machalliance.org/), Voucherify follows the principles of **composability**, giving you flexibility and decreasing the time needed for integration.  
+
+![How Voucherify works with your system and our rules engine](https://files.readme.io/d362b66-guides_getting_started_welcome_to_voucherify_voucherify_workflow_scheme_01.png "How Voucherify works with your system and our rules engine")
+
+## Who uses Voucherify and why?
+
+Voucherify can be successfully adopted across industries in B2C and B2B contexts – from ecommerce to travel and mobile on-demand services.
+
+Leveraging targeted promotions at every stage of the customer lifecycle can help you maximize engagement. This way, you can acquire customers through social media promotion, convert them with a welcome offer, grow them as customers via referrals, and ultimately, build better retention tactics with smart loyalty campaigns and re-engage them with incentives tailored to their profiles. This is the perfect scenario that each brand should aspire to achieve. But to get there, you need proper technology. 
+
+![Promotion lifecycle](https://files.readme.io/205a42e-guides_getting_started_welcome_to_voucherify_acquisition_to_re-activation_diagram-02.png "Promotion lifecycle showing acquisition, conversion, growth, retention, and re-activation")
+
+## Retail – Ecommerce & POS
+
+
+Voucherify is perfect for ecommerce brands transitioning to MACH and building a standard tech stack for their brands. We work great with commercetools and other MACH tools when it comes to scaling across multiple countries/brands, including integrating various business models (DTC, B2B, marketplace).
+
+Voucherify enhances store capabilities with advanced promotions, crucial for revenue. At the same time, Voucherify opens the door to loyalty and referral programs without the need to integrate any additional platform.
+
+<!-- Customer story – CASA 
+
+Discover the full story 
+
+DTC Ecommerce -->
+
+<details>
+<summary>Customer story – Breville</summary>
+
+[Breville](https://www.breville.com/us/en/home/index.html "Breville website") is an iconic global brand known for its extensive line of premium home appliances, particularly blenders and coffee machines.
+
+In pursuit of building new direct-to-consumer sales channels, Breville began its digital transformation journey. They chose [commercetools](https://www.voucherify.io/integrations/commercetools "Integration between Voucherify and commercetools") as their MACH-compliant commerce platform.
+
+As the marketing team was coming up with more complex use cases, soon the default campaign configuration options provided by commercetools were not enough for Breville’s needs.
+
+And so, the team started looking for [a MACH-compliant promotion engine](https://www.voucherify.io/learn/promotion-engine-how-to "Voucherify as a promotion engine") that could quickly integrate with their commerce platform. Voucherify soon proved to be the winning solution thanks to the robust rules engine and metadata capabilities to support business- and brand-specific campaigns.
+
+As a result, Breville achieved with Voucherify:
+- Substantial time and financial savings on developing a promotion tool from scratch.
+- Integration of best-of-breed headless commerce solutions to deliver better customer experience on a global scale.
+- Shortened time-to-market and the possibility to iterate quickly for introducing new campaigns to other Breville brands.
+- Increased campaign personalization and order conversions driven by targeted incentives.
+
+Read the [whole Breville story](https://www.voucherify.io/customers/breville "How Breville is Winning Digital Transformation with Voucherify and Friends").
+
+</details>
+
+## On-demand services
+
+Whether it’s fin-tech, ed-tech, mobility, or anything else, Voucherify is a driving force for customer engagement (especially in the context of recent changes in ad tracking). With a flexible data model and integrations with leading CDP and CRM platforms, mobile apps can make the most of the collected data in minimal time.
+
+<details>
+<summary>
+Customer story – Taxfix
+</summary>
+
+[Taxfix](https://taxfix.de/) is a Germany-based high-growth fintech startup that provides a mobile app designed to simplify and streamline the tax filing process.
+
+Key challenges for Taxfix:
+- Finding an API-first referral and discounting solution.
+- Connecting the promotion engine with other marketing automation tools. 
+- Enhancing revenue generation from the Taxfix user base via referrals and targeted offers.
+
+To maximize customer acquisition, Taxfix has previously employed referral tactics. However, their refer-a-friend initiatives lacked market receptiveness and user engagement, primarily due to outdated technologies and manual execution. That is why Taxfix turned to Voucherify and [Braze](https://www.braze.com/) to maximize their referral potential with modern API-first solutions.
+
+Voucherify equipped Taxfix with essential features to execute their bespoke referral campaign:
+- Referral program setup
+- Omnichannel engagement
+
+As a result, Taxfix achieved with Voucherify:
+- 95% increase in referral-driven sign-ups.
+- Accelerated iteration time and lower development costs.
+- Accelerated time to value and quick mix and match of campaign scenarios due to deploying API-first tools.
+- 90% more referrals made compared to previous program editions.
+
+Read the [whole Taxfix story](https://www.voucherify.io/customers/taxfix "How Taxfix increased referral registrations by 95% with Voucherify and Braze?")
+
+</details>
+
+## QSRs
+
+
+QSRs often need to handle a large volume of data in real-time. Voucherify provides a scalable infrastructure to support the creation, distribution, and management of rewards and incentives in both slow and peak periods. Voucherify API can be integrated with POS, mobile apps, web apps, and other devices, allowing QSR brands to run omnichannel promotions.
+
+<details>
+<summary>
+Customer story – BAEMIN
+</summary>
+
+[BAEMIN](https://baemin.vn/) was born in June 2010, with the desire to "Helping people eat delicious food anytime, anywhere." In 2019, BAEMIN officially entered the Vietnam market and became one of the largest players there, having about 5 million customers.
+
+Key challenges for BAEMIN:
+- Saving development time with flexible coupon software. 
+- Capturing customers’ attention in a competitive market with unique incentives. 
+- Securing the promotion budget in a price-sensitive environment.
+
+BAEMIN Vietnam opted for time-limited unique coupon codes to grab customers’ attention and they were looking for a coupon solution that would allow their marketing team to generate and manage unique coupon codes and thematic campaigns with little to no IT development.
+
+As a result, BAEMIN achieved with Voucherify:
+- Over 60 million engaged users and over 800 campaigns launched with Voucherify
+- Flexible campaign management by the marketing team
+- Fast campaign time-to-market thanks to API-first built and Braze integration
+
+Read the [whole BAEMIN story](https://www.voucherify.io/customers/baemin "How BAEMIN Vietnam handled over 60 million redemptions in a coupon-hungry market")
+
+</details>
+
+## What problems does Voucherify solve?
+
+- Integrating promotions with external tools and dynamic customer touchpoints.
+- Paying too much for promotion maintenance and real-time monitoring of all digital offers.
+- Generating unsatisfactory ROI with cookie-cutter offers, low-key loyalty programs, and promotional fraud.
+- Continuously mediating between marketing and development teams' priorities. 
+- Writing extra code to keep multiple promotion and loyalty platforms in sync across applications, brands, and teams.
+- Struggling to build branded customer-facing UIs using legacy and monolithic services.
+- Failing to effectively manage traffic spikes and priority changes.