Service Plan Integration
Prepare your connector now. The owner will configure service plans, prices and metrics separately.
What To Request
Select Service Plan Connector in your tenant application. Upload integration documentation describing how your app will map an app-specific member reference and respond to activation, update, pause, cancellation, expiry and revocation. No plan metrics or prices are required for connector preparation.
Connect After Approval
After profile verification, reporting-link review and application-key issuance, TIB can prepare your app-scoped connector credential. Store it on your server. Request GET https://tibsecured.com/api/plan-connectors/events with Authorization: Bearer followed by the issued credential. Save nextCursor and send it as the after query parameter on the next request. Process event IDs once, even when replayed.
Current Status: Awaiting Plans
Prepared connectors return pending_plans, plansConfigured: false and an empty event list. No service plans, pricing, quotas, member subscriptions or live entitlement publication are created by preparing the connector. Live publication requires a later approved plan-to-service mapping, verified billing source, member authorization and acceptance tests.
Subscription Status Contract
Contract tib-service-plans-1 reserves eventId, eventType, appId, app-specific subject, subscriptionReference, planReference, serviceReferences, status, effectiveAt and version. Event types are subscription.activated, subscription.updated, subscription.paused, subscription.canceled, subscription.expired and subscription.revoked. No payment credentials, contact details, prices or usage metrics are included.
Acceptance And Ongoing Access
Test credential rejection, app isolation, empty pending state, cursor handling, duplicate-event processing and revocation before live activation. An expired or revoked TIB application key blocks connector access. The app must stop service access when an approved entitlement is revoked or expires. Public app approval does not authorize receiving every member’s subscription.
Request The Connector