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