The following guide explains how to create and accept payments using Satispay Fringe Benefits.
In this page, you can find the specific request parameters that you can use for Fringe Benefit payments.
To read the generic API specification please refer to this page.
Payment creation
If your shop has Fringe Benefits enabled, Fringe Benefits will be used based on the user's Fringe Benefit availability.
These Fringe Benefits will be applied if the user sets the Fringe Benefits wallet as their primary wallet.
It is not possible to have a combination of Fringe Benefits and Meal Vouchers in the same payment, since these two payment methods are mutually exclusive; however, it is possible to include Satispay Fringe Benefits and e-money in the same payment.
Furthermore, it is possible to define the maximum number and the maximum amount of Fringe Benefits that can be used for a single payment.
If you do not set these parameters, and if your shop has Fringe Benefits enabled, Fringe Benefits will be automatically used based on the consumer's Fringe Benefits availability.
Partial payments
When integrating Satispay Fringe Benefits in cash registers / tills is required to implement what we call partial payment.
This will allow to accept payments from consumers that have Fringe Benefits only in their Satispay app.
Refunds
Refunds are only possible by the end of the month of the payment creation and for the total amount of the payment.
Partial refunds in payments with Fringe Benefits 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
Fringe Benefits payments cannot be partially refunded.
You must setamount_unitwith the total amount of the payment.