{"openapi":"3.1.0","info":{"version":"0.0.1","title":"0Wallet External Operator Outbound Webhooks","description":"Outbound webhook contract (us → operator) for player events. On `deposit` / `withdraw` / `register` we POST a plain JSON body (no headers, no signature) to every active row in `external_webhook_endpoints` matching that event for the tenant. Fired once via `SendExternalWebhookJob` (10s timeout, `tries=1`) — no retry and no dedupe id; if the operator was down they reconcile via `getAllTransactions`. The outcome (status code + body, success or failure) is logged as a `direction=out` row in `external_api_logs` regardless.\n"},"webhooks":{"deposit":{"post":{"summary":"Deposit completed","description":"Payload built by `App\\Services\\External\\Outbound\\DepositEvent`.","tags":["External / Outbound"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundDepositPayload"},"examples":{"deposit":{"value":{"id":"019eb092-0f3b-7376-8413-fc2b7758fd43","userId":"01KRZHBCQJ8MRX2YQV99CNCCDE","amount":"200.00","createdDateTime":"2026-02-05T02:48:10+00:00","transactionType":"DEPOSIT","transactionStatus":"COMPLETED"}}}}}},"responses":{"200":{"description":"Any response is accepted; not inspected beyond logging the status code and body."}}}},"withdraw":{"post":{"summary":"Withdrawal completed","description":"Payload built by `App\\Services\\External\\Outbound\\WithdrawEvent`. `amount` is always negative.\n","tags":["External / Outbound"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundWithdrawPayload"},"examples":{"withdraw":{"value":{"id":"019eb092-0f3b-7376-8413-fc2b7758fd43","userId":"01KRZHBCQJ8MRX2YQV99CNCCDE","amount":"-200.00","createdDateTime":"2026-02-05T02:48:10+00:00","transactionType":"WITHDRAW","transactionStatus":"COMPLETED"}}}}}},"responses":{"200":{"description":"Any response is accepted; not inspected beyond logging the status code and body."}}}},"register":{"post":{"summary":"User registered","description":"Payload built by `App\\Services\\External\\Outbound\\RegisterEvent`. Minimal payload — just the new user's internal id.\n","tags":["External / Outbound"],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboundRegisterPayload"},"examples":{"register":{"value":{"userId":"01JCHG2M8S2ABCDE0987654321"}}}}}},"responses":{"200":{"description":"Any response is accepted; not inspected beyond logging the status code and body."}}}}},"components":{"schemas":{"OutboundDepositPayload":{"type":"object","properties":{"id":{"type":"string","example":"019eb092-7ab8-7185-a84d-6dc85ec4e3cc"},"userId":{"type":"string","description":"The recipient's `member_id`.","example":"01KRZHBCQJ8MRX2YQV99CNCCDE"},"amount":{"type":"string","example":"200.00"},"createdDateTime":{"type":"string","format":"date-time","example":"2026-02-05T02:48:10+00:00"},"transactionType":{"type":"string","enum":["DEPOSIT"]},"transactionStatus":{"type":"string","enum":["COMPLETED"]}}},"OutboundWithdrawPayload":{"type":"object","properties":{"id":{"type":"string","example":"019eb092-7ab8-7185-a84d-6dc85ec4e3cc"},"userId":{"type":"string","example":"01KRZHBCQJ8MRX2YQV99CNCCDE"},"amount":{"type":"string","description":"Always negative for withdrawals.","example":"-200.00"},"createdDateTime":{"type":"string","format":"date-time","example":"2026-02-05T02:48:10+00:00"},"transactionType":{"type":"string","enum":["WITHDRAW"]},"transactionStatus":{"type":"string","enum":["COMPLETED"]}}},"OutboundRegisterPayload":{"type":"object","properties":{"userId":{"type":"string","description":"The new user's internal ID (ULID) — note this differs from the `member_id` used in deposit/withdraw payloads.","example":"01JCHG2M8S2ABCDE0987654321"}}}}}}