OPEN PLATFORM
APIs and events to build on the ecosystem
Immediate commands over synchronous APIs; fact propagation over asynchronous events. All idempotent, versioned and observable.
PRINCIPLES
Predictable integration
Versioned APIs
New fields are optional; removals are @deprecated with a clear deprecation window.
Idempotency
Idempotency keys on orders, tickets and payments — retries don't duplicate.
Reliable webhooks
Retries with backoff, a dead-letter queue and reconciliation.
CANONICAL CONTRACTS
The event catalog
Ecosystem facts, propagated consistently across products.
Identity & organizations
identity.linkedAn identity linked to an existing record.organization.createdA new organization created.membership.changedA member's role or status changed.
Subscriptions & access
subscription.activatedA contract activated for an organization.entitlement.changedAccess to a product or module changed.usage.recordedA billable metric recorded.
Customers
customer.createdA new customer, with source_system and source_id.customer.updatedA customer profile updated.customer.mergedProfiles deduplicated and merged.
Vifkart
order.createdAn order created.order.paidAn order paid and confirmed.order.cancelledAn order cancelled.order.refundedAn order refunded.
Ventus
ticket.reservedA ticket reserved, capacity held.ticket.issuedA ticket issued, with QR.ticket.validatedA ticket validated at check-in.ticket.cancelledA ticket cancelled.
Payments
payment.pendingA payment pending settlement.payment.succeededA payment completed.payment.failedA payment failed.settlement.completedSettlement completed by the partner.
Inventory
inventory.reservedStock reserved, with version and reason.inventory.adjustedStock adjusted.inventory.releasedA reservation released.
VENDASOS LAB
A lab to experiment without fear.
Per-organization sandboxes with fictional data and test keys — build and test integrations against the whole ecosystem without touching production.
Per-organization sandbox
An isolated environment with your fictional store, events and customers — a safe mirror of production.
Test keys and modes
Test credentials with the same API and event contracts; going to production is just swapping the key.
Simulated payments
Payment, dispute and refund flows simulated end to end — no real money.
Webhook replay
Resend events, inspect payloads and test idempotency without waiting for real traffic.
Anti-corruption layer
Adapters translate Vifkart's and Ventus's current models into canonical contracts — the new model stays protected from the particularities of existing systems.
Build on stable contracts
Talk to us about API access, events and test environments.