# Jackpot Studio Integration Tester

> Self-service tester for casino operators who integrate with the Jackpot Studio RGS (remote game server). The operator implements five HMAC-signed wallet callback endpoints (authenticate, balance, debit, credit, rollback). This tester calls those endpoints like the RGS does and reports pass/fail for each rule.

The tester calls operator wallets only from these IP addresses (allowlist them): `18.158.57.148` `63.188.86.202`

To integrate an operator backend, read the full specification first. It contains the complete callback contract, the signing scheme, the idempotency rules and the tester's JSON API.

## Docs

- [Full specification](https://staging-integration.jackpot.studio/llms-full.txt): wallet callback contract, HMAC signing, status codes, idempotency, test catalog and tester API in one file
- [Integration prompt](https://staging-integration.jackpot.studio/prompt.md): a ready-made task prompt for a coding agent working in the operator's codebase
- [OpenAPI schema](https://staging-integration.jackpot.studio/openapi.yaml): OpenAPI 3.1 schema of the five callbacks the operator implements

## Tester API

- [List tests](https://staging-integration.jackpot.studio/api/v1/tests): `GET`, JSON list of test IDs, names and categories
- `POST https://staging-integration.jackpot.studio/api/v1/runs`: start a run with `{"baseUrl","hmacSecret","playerId","operatorId"?,"currency"?,"testIds"?,"categories"?}`
- `GET https://staging-integration.jackpot.studio/api/v1/runs/{id}?wait=50`: run status and per-test results with assertions and raw HTTP logs