# OrbiSportbook integration

> Integrate the iframe sportsbook with an existing casino account and wallet. Hosted deployment at publication: staging. Confirm environment and go-live authorization; never assume production readiness.

## Start here

- [en agent guide](https://api.orbisportbook.com/docs/ai-integration.md): Requirements, implementation sequence, acceptance tests and a copy-ready prompt.
- [pt-BR agent guide](https://api.orbisportbook.com/docs/pt-br/ai-integration.md): Requirements, implementation sequence, acceptance tests and a copy-ready prompt.
- [Integration manifest](https://api.orbisportbook.com/docs/contracts/ai-integration.json): Machine-readable entrypoints and contract links.

## Contracts

- [Wallet OpenAPI](https://api.orbisportbook.com/docs/contracts/seamless-wallet.openapi.json): Four operator-hosted callbacks, signed requests, financial acknowledgements.
- [Aggregator OpenAPI](https://api.orbisportbook.com/docs/contracts/aggregator.openapi.json): Authorized client provisioning, activation and key rotation.
- [Offline HMAC vector](https://api.orbisportbook.com/docs/contracts/signature-test-vector.json): Public fixture, not live credentials or a current timestamp.

## Reference reading order

- [sessions](https://api.orbisportbook.com/docs/sessions/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/sessions/
- [wallet](https://api.orbisportbook.com/docs/wallet/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/wallet/
- [embedding](https://api.orbisportbook.com/docs/embedding/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/embedding/
- [postmessage](https://api.orbisportbook.com/docs/postmessage/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/postmessage/
- [testing](https://api.orbisportbook.com/docs/testing/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/testing/
- [certification](https://api.orbisportbook.com/docs/certification/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/certification/
- [security](https://api.orbisportbook.com/docs/security/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/security/
- [go-live](https://api.orbisportbook.com/docs/go-live/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/go-live/
- [aggregators](https://api.orbisportbook.com/docs/aggregators/): English; Portuguese at https://api.orbisportbook.com/docs/pt-br/aggregators/

## Boundaries

The casino owns authentication, KYC, eligibility, deposits, withdrawals and the wallet ledger. OrbiSportbook owns sportsbook functions. Use backend credentials only on servers; browser receives a single-use launch token. Financial tests use authorized local/sandbox accounts and fictitious funds. Read the linked contracts before implementation; do not invent endpoints or treat browser events as financial authority.