Documentacao da API

Introducao

Bem-vindo a documentacao da API da XRP Games!

Nossa API foi desenvolvida seguindo os padroes REST mais modernos, proporcionando uma experiencia de integracao simples e eficiente. Utilizamos protocolos HTTP padrao, autenticacao segura e respostas em formato JSON.

Caracteristicas Principais

• API RESTful com respostas em JSON
• Autenticacao via Bearer Token
• Rate limiting de 1000 requisicoes por minuto
• Webhooks para notificacoes em tempo real
• SLA de 99.99% de disponibilidade
• Suporte a idempotencia para operacoes criticas

IPs do Servidor

34.95.177.154
35.247.216.72
35.199.108.189
34.151.210.0
35.199.116.245

Primeiros Passos

Siga estas etapas para comecar a integrar com a API da XRP Games:

1. Criar uma Conta

Se voce ainda nao possui uma conta, clique aqui para criar. Apos a aprovacao, voce recebera suas credenciais de acesso.

2. Obter Credenciais

Apos a aprovacao da conta, voce recebera:

• Client ID: Identificador unico da sua aplicacao
• Client Secret: Chave secreta para autenticacao
• API Token: Token de acesso para as requisicoes

3. Ambiente de Testes

Autenticacao

A API da XRP Games utiliza autenticacao Bearer Token. Todas as requisicoes devem incluir o token no header.

Requisicao

curl --location --request POST 'https://api.xrpgames.com.br/v1/auth/token' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "client_id": "seu_client_id",
    "client_secret": "seu_client_secret",
    "grant_type": "client_credentials"
}'

Resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 3600,
  "issued_at": "2025-01-07T10:30:00Z"
}

Usando o Token

Authorization: Bearer seu_access_token

Pix Cash-In

O Pix Cash-In permite receber pagamentos atraves de QR Code ou codigo copia e cola. O pagador tem ate 20 minutos para concluir o pagamento.

Parametros

Requisicao

curl --location --request POST 'https://api.xrpgames.com.br/v1/pix/cash-in' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer seu_token' \
  --data-raw '{
    "amount": 150.00,
    "description": "Pagamento do pedido #12345",
    "payer": {
        "name": "Joao Silva",
        "document": "12345678900"
    },
    "expiration": 1200,
    "external_id": "pedido-12345",
    "webhook_url": "https://seu-site.com/webhook/pix"
}'

Resposta de Sucesso

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "external_id": "pedido-12345",
  "status": "pending",
  "amount": 150.00,
  "description": "Pagamento do pedido #12345",
  "qr_code": "00020126580014BR.GOV.BCB.PIX...",
  "qr_code_image": "data:image/png;base64,...",
  "expires_at": "2025-01-07T10:50:00Z",
  "created_at": "2025-01-07T10:30:00Z"
}

Consultar Status

Suporte

Estamos aqui para ajudar voce a integrar com sucesso.