Paginação e convenções

Paginação

Listagens paginadas (hoje, o extrato GET /players/{playerId}/transactions) usam cursor e devolvem os itens do mais recente ao mais antigo:

{ "data": [ { "id": "LDG-…", "type": "DEPOSIT", "amount": "100.00" } ], "nextCursor": "eyJ…" }

• Envie limit (1 a 200, padrão 50) e, para a próxima página, o cursor igual ao nextCursor recebido.
• Quando nextCursor for null, não há mais páginas.
• Trate o cursor como opaco: não o monte nem o interprete. Um cursor inválido retorna 422.

Convenções gerais

• Valores monetários são strings decimais com 2 casas ("100.00"), na moeda do jogador; nunca use ponto flutuante. Nas requisições, envie strings positivas com até 2 casas.
• Datas e horas em ISO 8601, sempre em UTC (2026-01-31T14:00:00.000Z); datas de nascimento em YYYY-MM-DD.
• Identificadores são opacos: não interprete nem ordene por eles. O id do jogador é do BetBackoffice; o externalId é o seu.
• Campos novos podem ser adicionados a qualquer momento nas respostas: ignore campos desconhecidos.
• CPF com ou sem pontuação; a API devolve somente dígitos.
• Busca por externalId: GET /players?externalId=… devolve { "data": [...] } (lista vazia se não existir).
• Toda resposta traz X-Request-Id.