The following guide explains how to create and accept payments using Satispay Meal Vouchers.

In this page, you can find the specific request parameters that you can use for Meal Voucher payments.
To read the generic API specification please refer to this page.

Payment creation

If your shop has Meal Vouchers enabled, Meal Vouchers will be used based on the user's Meal Voucher availability.
These Meal Vouchers will be applied if the user sets the Meal Vouchers wallet as their primary wallet.

It is not possible to have a combination of Meal Vouchers and Fringe Benefits in the same payment, since these two payment methods are mutually exclusive; however, it is possible to include Satispay Meal Vouchers and e-money in the same payment.

Furthermore, it is possible to define the maximum number and the maximum amount of Meal Vouchers that can be used for a single payment.
If you do not set these parameters, and if your shop has Meal Vouchers enabled, Meal Vouchers will be automatically used based on the consumer's Meal Vouchers availability, with a default limit of 8 Meal Vouchers per payment.

Partial payments

When integrating Satispay Meal Vouchers in cash registers / tills is required to implement what we call partial payment.
This will allow to accept payments from consumers that have Meal Vouchers only in their Satispay app.

Refunds

Refunds are only possible on the same day of payment creation and for the total amount of the payment.
Partial refunds in payments with Meal Vouchers are not available.

To perform refunds you need to create a new payment with the REFUND flow.
You will need to send the parent_payment_uid with the payment id that you want to refund and the total amount_unit of the parent payment.

We suggest you to fill the external_code with your internal order id, in order to better reconcile refunds in your payment reports.
This field will also be shown to the user via the Satispay app.

🚧

Partial refund

Meal Voucher payments cannot be partially refunded.
You must set amount_unit with the total amount of the payment.

REQUEST