Monitoring Periodic Payments

For periodic payments, the "accepted" status update refers to the approval a standing recurring payment order, which will be executed on a future date.

1. Periodic Payment uses the standard PaymentStatusChanged webhook.
2. For periodic payments, finalAmount may arrive as false instead of an object because the final settled amount of each future occurrence is not known yet. Do not treat finalAmount: false as a parsing error for periodic payments. Handle both object and boolean values.
3. For Periodic-Payments, the following fields will be added to the webhook payload
   

   Field	Type	Description	Example
   recurring	Boolean	if true the payment is recurring periodically (monthly). *only sent for periodic payments.	“True”
   startDate	ISODate	the first execution date of periodic payments. *only sent for periodic payments.	“2025-12-12"
   occurrences	number of occurrences	The number of times a periodic payment transactiom will be executed. If not-sent, the payment has no pre-defined occurences and will continue until cancelled. *only sent for periodic payments	3

Monitoring for cancellation

Feezback monitors the periodic payment order periodically, and sends a PaymentStatusChanged webhook update with the status "cancelled", when the debtor cancels the order via the bank's channels.