IOSOR Learn

Validate Product Catalog Definitions in Staging Before Tenant Exposure

Master the staging workflow for IOSOR catalog management. Ensure pricing, webhook routes, and JIT number provisioning are verified before your tenants go live.

Misconfigured pricing tiers and broken routing rules can disrupt your live tenant environments. Validating your catalog within a staging environment prevents these errors from reaching production. Use the IOSOR console to safely verify your MRC structures and webhook endpoints.

Configuring the Staging Environment.

Before exposing your catalog to tenants, you must validate all definitions within the staging environment. This phase ensures that your pricing rules, MRC structures, and webhook endpoints are correctly mapped. Use the IOSOR console to define your service tiers and verify that the ledger correctly reflects the USD 20 prepaid floor required for account activation. By isolating these configurations, you prevent mispricing or routing errors from impacting your production environment.

Validating Webhook Routes and DLR Logic

Testing your webhook integration is critical for reliable communication. Configure your staging endpoints to receive real-time DLR and incoming SMS notifications. Verify that the payload structure adheres to the expected E.164 formatting and that your system correctly processes the Verify OK status. Ensure that your logic handles STOP requests gracefully, maintaining compliance without manual intervention. This step confirms that your backend is ready to process high-volume traffic once the catalog is live.

JIT Provisioning and Number Assignment

IOSOR utilizes JIT provisioning to ensure that numbers are assigned dynamically upon request. In staging, simulate the acquisition process to confirm that the ledger deducts the correct MRC from the tenant balance. Since there is no physical inventory, verify that your API calls successfully trigger the assignment of E.164 numbers without latency. This ensures that your tenants experience direct service activation the moment they select a number from your catalog.

Pricing Rules and Financial Thresholds

Audit your pricing rules to ensure that all margin calculations are applied correctly. During this phase, monitor the account balance behavior as it approaches the soft review threshold of USD 1,000/month. This review is a standard procedure to ensure your platform scaling remains aligned with your business model. Confirm that the system triggers the appropriate alerts when balances drop below the prepaid floor, ensuring uninterrupted service for your end users.

Cross-Environment Consistency Checks

Consistency between staging and production is the foundation of a stable platform. Ensure that your API keys, secret management, and webhook signatures are identical in structure across both environments. Use the following resources to align your deployment strategy:

Start with IOSOR

Log into the IOSOR console and navigate to your catalog settings in staging mode before pushing updates to production. Execute end-to-end test runs to verify that webhook routes deliver DLR payloads properly and JIT provisioning calculates MRC deductions against test tenant balances. Once all pricing rules and payload signatures pass verification, switch your catalog status from draft to live.

IOSOR takeaway

Validating catalog draft configurations in a controlled staging sandbox prevents unexpected billing discrepancies and broken webhook notifications for active tenants. Thorough testing of dynamic JIT number assignment and E.164 payload formatting ensures your downstream application processes delivery reports without friction.

Was this guide helpful?

Related guides