Unlike spending a certain monetary value from vouchers or credits, prepayment allows merchants to let their customers top up vouchers or credits for future consumption.

As defined in Get benefit offer, balance values such as valueToUseInCurrency, controllableValueToUse, nonControllableValueToUse are representing the monetary value spending, whereas prepayment represents the value to be used by customer to top-up their credits or vouchers for future use.

The benefit provider, upon scanning a voucher or customer code, must determine which balance is used for prepayment and which for spending, and follow the Get Benefit Offer structure accordingly. It is not possible to spend and prepay within the same balance object.

This flow can also be used for voucher activation, as the POS system is abstracted from the actual state of the voucher. It is the partner’s responsibility to provide information on whether and how the voucher can be prepaid.

Prepayment implementation—by creating a balance upon scanning the QR code—follows the exact same workflows as described in the introduction diagrams in introduction, including Get Benefit Offer and error & usage reporting.

Prepayment operations are reported in the benefitUsages in the same way as spending transactions. Additionally, the POS must create a new bill item to represent the prepayment action.

There is not possibility to scan voucher to an empty basket. So there is a recommandation for voucher activation: in admin product detail to set "Voucher activation" product with 0 price and set this product not to be printed on the bill (works only with 0 CZK items).

For further details, as well as structure and validation rules, please consult Get benefit offer.

Balance Types Supporting Prepayment

Prepayment functionality is only available for the following balance types:

✅ SPV (Single Purpose Prepaid Voucher) - singlePurposePrepaidVoucher

✅ MPV (Multi Purpose Prepaid Voucher) - multiPurposePrepaidVoucher

❌ Points (Collectable Points) - collectablePoints

✅ Credits(Prepaid Credit) - prepaidCredit

Prepayment

Balance Types Supporting Prepayment#

Balance Types Supporting Prepayment