Refunds with Credit

Refundable Items (Cups/Glasses)

This is a recommended approach to be used for for merchants who want to implement a deposit system for refundable items, like cups or glasses, using a credit payment. This document describes how to use a credit payment for refundable items and how to recharge/refund credit when these items are returned by customer.

Note: This is a workaround solution. The loyalty API does not currently support automatic credit refunds. The loyalty provider must handle credit recharges on their own system.

Admin Setup (Merchant Configuration)

Create a new product with a positive price for the refundable item (e.g., "Refundable Cup", price: 50 CZK)

Create a corresponding product with the same price but negative (e.g., "Cup Refund", price: -50 CZK)

Create a new payment method, e.g., "Recharge Credit"

Get Benefit Offer Webhook - Requests/Responses Scenarios

Benefit requests from POS are resent by loyalty API to a loyalty provider. These are scenarios with refundable items - requests from loyalty API and expected loyalty provider responses.

Scenario 1: Purchasing a Refundable Cup (to pay it by credit)

Loyalty API sends a request with an item (e.g., a cup) as a regular item with positive price

Loyalty provider response should be a standard response where the cup is paid with a credit (MPV voucher or card)

Scenario 2: Returning a Refundable Cup with a credit recharge

Loyalty API sends the negative item (e.g., "Cup Refund" at -50 CZK)

Loyalty provider should:

Recharge credit on their own system (e.g., +50 CZK)

Return empty balances and discounts

Include POS and bill messages with information that credit has been recharged

POS user should complete the transaction using the "Recharge Credit" payment method

POS will generate a bill with the total -50 CZK and the bill message about a credit recharge

Scenario 3A: Returning Cup + Purchasing Other Products (Positive Total)

Example: "Beer" at 100 CZK + "Cup Refund" at -50 CZK = 50 CZK total

Loyalty API sends the negative item together with regular items

Loyalty provider should apply credit payment to remining positive value (e.g., 50 CZK total)

POS will generate a bill with 50 CZK paid by credit

Scenario 3B: Returning Cup + Purchasing Other Products (Negative Total)

Example: "Small Beer" at 30 CZK + "Cup Refund" at -50 CZK = -20 CZK total

Loyalty API sends the negative item together with regular items

Loyalty provider should:

Return empty balances and discounts

Recharge credit for remaining negative value (e.g., -20 CZK total)

Include POS and bill messages with information that credit has been recharged (e.g., 20 CZK)

POS user should complete transaction with "Recharge Credit" payment method

POS will generate a bill with the bill message about 20 CZK credit recharge

Refundable Credit

Generally, loyalty programs do not support money refunds for unused credit. However, for non-loyalty use cases (e.g., festivals, wellness centers), merchants may want to implement refundable credit that can be returned to customers at the end of an event. This functionality is currently under consideration for future development.

Item refunds with credit

Refunds with Credit#

Refundable Items (Cups/Glasses)#

Admin Setup (Merchant Configuration)#

Get Benefit Offer Webhook - Requests/Responses Scenarios#

Scenario 1: Purchasing a Refundable Cup (to pay it by credit)#

Scenario 2: Returning a Refundable Cup with a credit recharge#

Scenario 3A: Returning Cup + Purchasing Other Products (Positive Total)#

Scenario 3B: Returning Cup + Purchasing Other Products (Negative Total)#

Refundable Credit#