Ayatickets Developer Platform Developer API
Sign in Get API keys
Sandbox

Sandbox walkthrough

Test the full Ayatickets integration flow safely — no real money, no ticket inventory held, simulated checkout only. Complete these steps before switching to live keys.

Create your developer account

Register at the Ayatickets Developer Platform and verify your email. This gives you access to apps, API keys, and private integration docs.

Create account

Create an app and generate a test key

In your dashboard, create a Developer App and generate an API key with environment set to Test. The key prefix will be ayt_test_. Store it securely — it is shown only once.

Open dashboard

Browse events and ticket inventory

Call GET /api/v1/events to list published events, then GET /api/v1/events/{id}/dates and GET /api/v1/event-dates/{id}/tickets to read inventory and pricing.

View API reference

Create a sandbox checkout session

POST /api/v1/checkout-sessions with your test key and an Idempotency-Key header. Test keys use sandbox checkout only — no production payments or real ticket reservations. You receive a sandbox checkout_url and an sbx_ order reference.

Simulate payment on the sandbox page

Open the checkout_url in your browser. Choose Simulate successful payment, Simulate failed payment, or Simulate expiry. This triggers the same webhook events your production integration will receive.

Confirm order status and webhooks

Poll GET /api/v1/orders/{reference} with the same test key. Configure a webhook URL on your app to receive order.paid, order.failed, and order.expired events with environment: test in the payload.

Integration guide

Go live when you are ready

Generate an ayt_live_* key only when you are ready for production checkout on ayatickets.com. Live keys require explicit confirmation because they process real customer payments.

Quick tip

Test and live keys are fully isolated. A test key cannot read live orders, and live keys cannot access sandbox sbx_* references.