IOSOR Learn
When Grace Ends Send Pauses — Live is Not Fake-Success
Understand how IOSOR handles traffic once the auto-recharge grace period expires. Learn about traffic_ok flags, ledger logic, and why we never return fake success for failed sends.
When Grace Ends Send Pauses — Live is Not Fake-Success.
The Transition from Grace to Hard Stop
In the IOSOR ecosystem, the auto-recharge mechanism is designed to prevent service interruption during minor payment delays. However, once the defined grace period for a failed card transaction expires, the platform shifts from a permissive state to a hard stop. This transition is critical for maintaining the integrity of the prepaid model. Unlike platforms that might allow debt to accumulate indefinitely, IOSOR enforces a strict ledger-based cutoff.
Ledger Logic and Traffic_OK Flags
Every transaction within the platform is governed by a real-time ledger. When a message request is received via API or webhook, the system checks the traffic_ok flag associated with your sub-account. If the auto-recharge grace period has lapsed, this flag is revoked. ops must note that IOSOR does not practice 'fake-success' reporting.
JIT Number Management and MRC Holds
Number resources in IOSOR are managed through a Just-In-Time (JIT) allocation system. When a balance enters a hard-stop state after a failed grace period, the system must still account for Monthly Recurring Charges (MRC) for any E.164 numbers currently assigned to your account. To prevent the loss of these numbers, the platform may place a 'prepaid hold' on the remaining cents in the wallet.
Handling OTP and SMS Webhook Responses
When the system enters a pause state, the API response for outgoing OTP or SMS requests will change from a standard 202 Accepted to a specific error code indicating a balance-related block. It is vital for your application to parse these responses correctly. Instead of receiving a Verify OK token, your system will receive a notification that the message was suppressed.
Compliance and Transparency Resources
To better manage your wallet and understand the nuances of traffic suppression, we recommend reviewing our detailed guides on balance controls and delivery truth. These resources explain the underlying mechanics of how we handle skipped messages and the specific rules governing failed card attempts. Monitoring these settings helps prevent unexpected downtime in production environments.
Related: Auto-recharge so Live traffic does not stall · Processor retry must not double a top-up · Prepaid hold before first debit.
Start with IOSOR
Navigate to your IOSOR Console to inspect your payment fallback triggers and webhook error handling. Ensure your application logic explicitly handles API error codes returned when traffic_ok evaluates to false after a failed-card grace period. Test your queue worker to verify that outbound dispatch pauses instantly instead of expecting fake delivery receipts.
IOSOR takeaway
This article proved that IOSOR enforces real-time ledger state without delivering false-success status codes. Once the grace period for an auto-recharge attempt expires, the traffic_ok flag revokes outbound privileges, returning explicit API errors to protect ledger integrity.
Do configure your integration to listen for balance-related pause signals and halt outgoing SMS queues immediately. Don't silently swallow API rejection codes or assume traffic is being queued for delivery when grace has lapsed.
Was this guide helpful?
Related guides
- Processor retry must not double a top-up
Learn how IOSOR ensures idempotent auto-recharge transactions, preventing duplicate credits during payment processor retries while maintaining a USD 20 prepaid floor.
- Auto-recharge so Live traffic does not stall
Learn how to use threshold-based auto-recharge as a live-path control to prevent SMS and OTP delivery failures in your IOSOR environment.