{"openapi":"3.1.0","info":{"title":"Open Passage API","version":"2026-11-18","description":"Tenant-scoped payment orchestration API. Provider credentials are never accepted by this API."},"servers":[{"url":"https://{host}","variables":{"host":{"default":"api.openpassage.example"}}}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"Open Passage API key"}},"schemas":{"PaymentIntentInput":{"type":"object","required":["clientReference","fundingAccountId","beneficiaryId","policyId","sourceAmount"],"properties":{"clientReference":{"type":"string"},"fundingAccountId":{"type":"string"},"beneficiaryId":{"type":"string"},"policyId":{"type":"string"},"sourceAmount":{"type":"string","pattern":"^\\d+(\\.\\d{1,6})?$"}}},"ProviderStatus":{"type":"object","required":["providerExecutionId","providerEventId","type","occurredAt"],"properties":{"providerExecutionId":{"type":"string"},"providerEventId":{"type":"string"},"type":{"type":"string","enum":["execution.accepted","payout.pending_funding","payout.pending_compliance","payout.in_transit","payout.completed","payout.failed","payout.returned"]},"occurredAt":{"type":"string","format":"date-time"}}}}},"paths":{"/api/v1/payment-intents":{"post":{"summary":"Create or replay a payment instruction","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":8,"maxLength":160}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentIntentInput"}}}},"responses":{"200":{"description":"Idempotent replay"},"201":{"description":"New instruction created"},"400":{"description":"Invalid payload or missing idempotency key"},"409":{"description":"Invalid setup or reused key with different input"}}}},"/api/v1/payment-intents/{id}/provider-status":{"post":{"summary":"Record a Northstar-observed provider lifecycle event","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProviderStatus"}}}},"responses":{"200":{"description":"Event accepted or deduplicated"},"409":{"description":"Selected connection is not Northstar-executed"}}}},"/api/v1/executions/{id}":{"get":{"summary":"Read execution state and normalized event history","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Execution and events"},"404":{"description":"Unknown execution"}}}}}}