On-Demand Payments
Integrate FixedOnDemand and VariableOnDemand payment types.
Goal: Let a payer pre-authorize a spending limit, then trigger individual debits as usage occurs, using the FixedOnDemand and VariableOnDemand types.
Estimated time: 20 minutes
Prerequisites
- Sandbox credentials (
appId,apiKey,tenant) - A registered creditor bank account
- Understanding of the mandate consent model
When to use
- Utility billing (charge after meter reading)
- Wallet top-ups within an approved limit
- Pay-as-you-go products where amount varies per charge
Payment types: FixedOnDemand, VariableOnDemand
Regions: UAE. Not available in KSA/Bahrain for all providers, confirm before build.
Flow overview
Integration summary
Create on-demand payment request
Set payment type to FixedOnDemand or VariableOnDemand. Define max amount or rules inside instructions.
Obtain mandate consent
Payer approves the maximum or rule set at the bank. Consent covers multiple future debits until expiry or revocation.
Trigger debits
When billable usage occurs, call mandate execution APIs (see Mandates API). Each debit must stay within authorized limits.
Reconcile
Track mandate transactions and payment records. Handle insufficient funds and expiry the same as periodic mandates.