Skip to main content

Unscheduled charges

An Unscheduled charge is a payment that happens instantly and is not part of a regular schedule. These are typically ad hoc or β€œone-off” charges created for an active payment agreement.

Example industries/use-cases​

Unscheduled charges are used in scenarios where payments are not planned ahead or when the total amount depends on certain factors. Here are some common use cases for unscheduled charges:

πŸ›΄ πŸš• On-demand ride services: Charging customers for rides once they are completed, based on distance and time.
πŸ”Œ Utility services: Charging for electricity consumption after the usage is determined, such as charging for electric vehicle charging.
πŸ…ΏοΈ Parking services: Charging based on the duration of stay when a vehicle leaves a parking facility.
🧾 Subscription overages: Billing for overages in cloud storage or data usage beyond the subscription limit.

Key features​

πŸ™ No retries​

If the charge fails, it does not retry automatically.

πŸ“‰ Lower conversion​

Charge success rate is 80% or lower. This is because there are no-retries and overview to the users in the app in advance.

πŸ’” User experience​

  1. No Overview: Users do not see upcoming charges in their app in advance.
  2. No Management: Users cannot proactively manage payment sources before the charge processing. Although they can manage payment methods from the agreement they have to remember the charging cycle and do it by themselves without the app aiding them.

🚫 No bulk charging​

Not supported for unscheduled charges.

🚦 Rate limits​

Up to 300 requests per minute.

πŸ—“οΈ Lead time​

The charge is created ad-hoc by the merchant and processed as early as possible.

API request snippet​

{
"amount": 12000,
"transactionType": "RESERVE_CAPTURE",
"description": "EV charging for 30 minutes",
"type": "UNSCHEDULED"
}

Help us improve our documentation

Did you find what you were looking for?