Recurring & Periodic Payments
Integrate FixedPeriodicSchedule and VariablePeriodicSchedule payment types.
Goal: Debit a payer on a repeating cadence (weekly, monthly, etc.) under one consent, using the FixedPeriodicSchedule and VariablePeriodicSchedule types.
Estimated time: 20 minutes
Prerequisites
- Sandbox credentials (
appId,apiKey,tenant) - A registered creditor bank account
- Familiarity with the single instant payment flow
When to use
- Subscriptions with fixed or variable renewal amounts
- Rent or installment plans with a known frequency
- Membership fees
Payment types: FixedPeriodicSchedule, VariablePeriodicSchedule
Regions: UAE (full support). KSA supports RECURRENT with a narrower model, confirm with Spare.
How it differs from single instant
| Single instant | Periodic schedule | |
|---|---|---|
| Consent scope | One debit | Series of debits until expiry |
| Mandate | Not required | Created after authorization |
| Instructions | Single amount | periodicSchedule with frequency and amount rules |
Integration summary
Create payment request with periodic instructions
Include periodicSchedule inside instructions with frequency, start date, and amount (fixed or max for variable).
Collect mandate consent
Payer authorizes the schedule, not just one payment. Use Spare Link or direct consent, payer sees schedule summary at the bank.
Monitor mandate transactions
After authorization, Spare creates a mandate. Each execution appears as a mandate transaction, poll or webhook.
Regional differences
UAE supports the full periodic schedule model. For KSA recurrent domestic payments, validate field requirements with your Spare solutions engineer before go-live.