curl --request POST \
  --url https://app.tagadapay.com/api/public/v1/test/execute-scenario \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scenarioId": "test-basic-001",
  "accountId": "acc_test",
  "storeId": "store_test"
}
'

{
  "success": true,
  "scenarioId": "test-basic-001",
  "eventId": "evt_abc123",
  "message": "Scenario dispatched successfully",
  "executionTimeMs": 250,
  "handlersDispatched": {
    "immediate": [
      "immediateCriticalHandler",
      "immediateAnalyticsHandler",
      "immediateParallelHandler"
    ],
    "deferredQStash": [
      "deferredQStashNotificationHandler",
      "deferredQStashRetryHandler"
    ],
    "deferredInngest": [
      "deferredInngestWorkflowHandler"
    ]
  }
}

test

Execute test scenario

Execute a test scenario to validate event system behavior.

This endpoint dispatches a test event (test/scenario-executed) that triggers 6 different handlers:

Immediate Handlers (run in HTTP request):

🔴 immediateCriticalHandler - Sequential, high priority
🟢 immediateAnalyticsHandler - Parallel, writes to appEvents
🟢 immediateParallelHandler - Parallel, fast operation

Deferred Handlers (run in background):

🔵 deferredQStashNotificationHandler - Via QStash backend
🟣 deferredInngestWorkflowHandler - Via Inngest backend
🟡 deferredQStashRetryHandler - Via QStash with retry config

Watch server logs for colored emoji indicators to trace execution flow.

POST

api

public

test

execute-scenario

curl --request POST \
  --url https://app.tagadapay.com/api/public/v1/test/execute-scenario \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "scenarioId": "test-basic-001",
  "accountId": "acc_test",
  "storeId": "store_test"
}
'

{
  "success": true,
  "scenarioId": "test-basic-001",
  "eventId": "evt_abc123",
  "message": "Scenario dispatched successfully",
  "executionTimeMs": 250,
  "handlersDispatched": {
    "immediate": [
      "immediateCriticalHandler",
      "immediateAnalyticsHandler",
      "immediateParallelHandler"
    ],
    "deferredQStash": [
      "deferredQStashNotificationHandler",
      "deferredQStashRetryHandler"
    ],
    "deferredInngest": [
      "deferredInngestWorkflowHandler"
    ]
  }
}

Authorizations

Authorization

string

header

required

Enter your API key as: Bearer your-api-key

Body

application/json

scenarioId

string

required

Unique identifier for this test scenario

accountId

string

required

Account ID for testing

storeId

string

required

Store ID for testing

testData

object

Optional test data payload

Show child attributes

Response

Successful response

Health check Execute test scenario with simulated failure

Documentation Index

Authorizations

Body

Response