docs
  1. Checkout-guide
  2. Features
  3. Loyalty Programs

Loyalty Programs

SCAYLE Checkout supports the interface and infraestructure for integrating any third-party loyalty programs directly into the payment step via APIs. This means tenants can implement loyalty cards of their choice—such as PAYBACK or other provider-backed programs—to allow customers to collect (earn) and burn (redeem) points during the checkout process. This functionality enables customers to:

  • Register or subscribe to a loyalty program during checkout,
  • Enter an existing membership number to collect loyalty points,
  • And, where supported, use loyalty points to partially or fully pay for the order.

While SCAYLE Checkout facilitates the input and transmission of loyalty data, it does not handle the underlying business logic for earning or redeeming points.

For earning points, SCAYLE relies on the calculation factor configured in the SCAYLE Panel for each loyalty program. This factor is multiplied by the order total to determine how many points a customer will receive after order confirmation.

For redeeming points, SCAYLE uses the conversion factor provided by the tenant to calculate the monetary value of a customer’s loyalty balance during checkout. For example, if a customer has 1,500 points and the conversion factor is set to 0.01, those points would equal 15.00 EUR (1,500 × 0.01).

All other loyalty logic—such as promotional code validation, bonus point calculation, or reward application—must be handled entirely by the middleware or the external loyalty provider.

User Flow

If a loyalty program is configured, the customer will see a dedicated loyalty section on the payment step of the checkout. Depending on the Loyalty Program configuration, this section provides options to either register for the program or enter an existing membership number.

Loyalty Program module in the Checkout

Registration

First-time users can register for a loyalty or membership program directly within the checkout flow using a dedicated registration form. Once completed, the newly registered loyalty account is linked to the order.

Earning Loyalty Points

Existing members can enter their loyalty card number to collect points with their purchase. Once entered, SCAYLE can validate and optionally verify the number through your middleware and the loyalty provider. Similarly to the registration, you will also find the attached card in the state response.

Customers can opt for removing the attached loyalty card from the input field. Once detached, the order will not earn points under the removed card.

After validation, the card balance will be checked. Based on the response, customers may use points to fully or partially pay for their order, depending on your loyalty provider’s logic. Users have the option to choose how many loyalty points they want to redeem during checkout.

Redeeming Loyalty Points

Full redemption

If a customer’s loyalty points are equal to or greater than the order total, the checkout can be completed without requiring any additional payment method.

Partial redemption

Partial redemption is supported, allowing customers to use only a portion of their available points and save the rest for future purchases.
When points are applied, the checkout state response reflects the updated total purchase price and the number of loyalty points deducted.

After all optional loyalty actions are completed, the checkout continues as usual. Loyalty data (card number, promo code, etc.) is included in the order submission and forwarded to your backend or middleware.

Supported Payment Methods

If you want to configure loyalty point redemption, please note that it is only supported with specific payment providers. The following methods allow partial payments with loyalty points:

  • Klarna (direct integration and through Adyen integration)
  • PayPal Instant Capture (direct integration)
  • Riverty
  • Gift Cards

If your preferred payment option is not listed, please reach out to your SCAYLE Account Manager for further guidance.

Loyalty point redemption with PayPal Instant Capture is not supported for recurring payments.