{
  "info": {
    "name": "DreamTechGames - Provider API v2",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Integração DreamTechGames v2. Leia /developer. Credenciais somente no backend. Consulte wallet_type no catálogo; não deduza carteira pela distribuição. Repetição financeira exige a mesma identidade e payload.\nIntegridade de entrega (19/10/2026): verifique /developer. Campos round_id/type/timestamp são condicionais ao envelope. Uma resposta incerta não autoriza reenviar. IDs igw:<recibo> são eventos próprios. Consulta de status é requisito de novas homologações e usa URL homologada do operador; não execute métodos exploratórios no callback financeiro.\nRequisitos para novas integrações (20/10/2026): consulta por ID transaction_status, comprovante durável após commit e proteção contra duplicação sequencial/concorrente são obrigatórios na homologação. Clientes existentes preservam seus contratos e podem acrescentar as funções após homologação específica. Esta coleção não ativa a consulta, não altera callbacks atuais e não deve executar testes financeiros em contas reais.\nFunções obrigatórias para liberar uma nova integração em produção. A consulta assinada por ID, o comprovante durável e a proteção contra duplicação precisam estar implementados e validados com a DreamTechGames.\n\nAtualização de 14/11/2026: Novos agentes: cadastre o callback HTTPS, configure as credenciais no servidor e implemente transaction_status nessa mesma URL. A validação assinada e a habilitação são automáticas. Antes da aprovação, game_launch retorna HTTP 409 AGENT_RECONCILIATION_PENDING. Nenhum pagamento é reenviado pela validação. Integrações existentes mantêm suas configurações."
  },
  "variable": [
    {
      "key": "base_url",
      "value": "https://dreamtechgames.fun"
    },
    {
      "key": "agentToken",
      "value": "SEU_AGENT_TOKEN"
    },
    {
      "key": "secretKey",
      "value": "SEU_AGENT_SECRET"
    },
    {
      "key": "user_code",
      "value": "123"
    },
    {
      "key": "operator_callback_url",
      "value": "https://cassino-do-cliente.exemplo/api/dreamtechgames/callback"
    }
  ],
  "item": [
    {
      "name": "GET providers",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/providers",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "providers"
          ]
        },
        "description": "\nAo Vivo: provedora v2 pode informar type=live, wallet_catalog=live e wallet_type=balance_playfiverPremium. Não altere o nome/código usado na abertura."
      }
    },
    {
      "name": "GET games",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/games?provider=DREAMTECHGAMES&page=1&per_page=50",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "games"
          ],
          "query": [
            {
              "key": "provider",
              "value": "DREAMTECHGAMES"
            },
            {
              "key": "page",
              "value": "1"
            },
            {
              "key": "per_page",
              "value": "50"
            }
          ]
        },
        "description": "\nAo Vivo: importar game_type=live, wallet_catalog=live e wallet_type=balance_playfiverPremium, percorrendo todas as páginas. Atualizar pela mesma identidade, sem duplicar. Esta classificação do catálogo não muda o callback financeiro: preserve game_type=slot e slot quando esse for o envelope homologado."
      }
    },
    {
      "name": "GET balances (preflight)",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "description": "Pré-condição do launch: consulte wallet_type no catálogo e confirme saldo na carteira indicada. A origem apiplayfiver pode estar no catálogo Standard ou Premium.",
        "url": {
          "raw": "{{base_url}}/api/v2/balances?agentToken={{agentToken}}&secretKey={{secretKey}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "balances"
          ],
          "query": [
            {
              "key": "agentToken",
              "value": "{{agentToken}}"
            },
            {
              "key": "secretKey",
              "value": "{{secretKey}}"
            }
          ]
        }
      }
    },
    {
      "name": "POST game_launch",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"secretKey\": \"{{secretKey}}\",\n  \"agentToken\": \"{{agentToken}}\",\n  \"user_code\": \"{{user_code}}\",\n  \"user_balance\": 100.5,\n  \"game_code\": \"fortune-tiger-dreamtechgames\",\n  \"provider\": \"DREAMTECHGAMES\",\n  \"lang\": \"pt\",\n  \"game_original\": false,\n  \"user_rtp\": 96\n}"
        },
        "url": {
          "raw": "{{base_url}}/api/v2/game_launch",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "game_launch"
          ]
        }
      }
    },
    {
      "name": "GET agent",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/agent?agentToken={{agentToken}}&secretKey={{secretKey}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "agent"
          ],
          "query": [
            {
              "key": "agentToken",
              "value": "{{agentToken}}"
            },
            {
              "key": "secretKey",
              "value": "{{secretKey}}"
            }
          ]
        }
      }
    },
    {
      "name": "PUT agent",
      "request": {
        "method": "PUT",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agentToken\": \"{{agentToken}}\",\n  \"secretKey\": \"{{secretKey}}\",\n  \"rtp\": 96,\n  \"bonus_enable\": true,\n  \"limit_enable\": false,\n  \"limit_amount\": 0,\n  \"limit_hours\": 0\n}"
        },
        "url": {
          "raw": "{{base_url}}/api/v2/agent",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "agent"
          ]
        }
      }
    },
    {
      "name": "POST free_bonus (individual)",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agentToken\": \"{{agentToken}}\",\n  \"secretKey\": \"{{secretKey}}\",\n  \"user_code\": \"{{user_code}}\",\n  \"game_code\": \"fortune-tiger\",\n  \"rounds\": 10,\n  \"idempotency_key\": \"jogador-123-rodadas-001\"\n}"
        },
        "url": {
          "raw": "{{base_url}}/api/v2/free_bonus",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "free_bonus"
          ]
        }
      }
    },
    {
      "name": "POST free_bonus (campanha geral)",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agentToken\": \"{{agentToken}}\",\n  \"secretKey\": \"{{secretKey}}\",\n  \"target_scope\": \"general\",\n  \"game_code\": \"fortune-tiger\",\n  \"rounds\": 100,\n  \"idempotency_key\": \"lote-agosto-2026\"\n}"
        },
        "url": {
          "raw": "{{base_url}}/api/v2/free_bonus",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "free_bonus"
          ]
        }
      }
    },
    {
      "name": "GET free_bonus",
      "request": {
        "method": "GET",
        "header": [
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{base_url}}/api/v2/free_bonus?agentToken={{agentToken}}&secretKey={{secretKey}}",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "free_bonus"
          ],
          "query": [
            {
              "key": "agentToken",
              "value": "{{agentToken}}"
            },
            {
              "key": "secretKey",
              "value": "{{secretKey}}"
            }
          ]
        }
      }
    },
    {
      "name": "DELETE free_bonus",
      "request": {
        "method": "DELETE",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"agentToken\": \"{{agentToken}}\",\n  \"secretKey\": \"{{secretKey}}\",\n  \"id\": 123\n}"
        },
        "url": {
          "raw": "{{base_url}}/api/v2/free_bonus",
          "host": [
            "{{base_url}}"
          ],
          "path": [
            "api",
            "v2",
            "free_bonus"
          ]
        }
      }
    },
    {
      "name": "Callback BALANCE",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"BALANCE\",\n  \"user_code\": \"{{user_code}}\"\n}"
        },
        "url": {
          "raw": "{{operator_callback_url}}",
          "host": [
            "{{operator_callback_url}}"
          ]
        }
      },
      "description": "Exemplo do envelope legado com type no topo. Não é um modelo universal: transaction/slot de PlayFiver/iGameWin e o Rabbit usam contratos específicos documentados em /developer. Não execute callbacks de teste em carteiras reais."
    },
    {
      "name": "Callback WinBet",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"WinBet\",\n  \"game_type\": \"slot\",\n  \"user_code\": \"{{user_code}}\",\n  \"agent_code\": \"SEU_AGENT_CODE\",\n  \"agent_secret\": \"SEU_AGENT_SECRET\",\n  \"user_balance\": 95.50,\n  \"slot\": {\n    \"provider_code\": \"PGSOFTGAMES\",\n    \"game_code\": \"fortune-tiger\",\n    \"type\": \"BASE\",\n    \"bet_money\": 5.00,\n    \"win_money\": 0.00,\n    \"txn_id\": \"TXN_UNICO\",\n    \"round_id\": \"ROUND_UNICO\",\n    \"txn_type\": \"debit_credit\",\n    \"user_before_balance\": 100.50,\n    \"user_after_balance\": 95.50,\n    \"timestamp\": \"2026-07-07T14:30:00-03:00\"\n  }\n}"
        },
        "url": {
          "raw": "{{operator_callback_url}}",
          "host": [
            "{{operator_callback_url}}"
          ]
        }
      },
      "description": "Exemplo do envelope legado com type no topo. Não é um modelo universal: transaction/slot de PlayFiver/iGameWin e o Rabbit usam contratos específicos documentados em /developer. Não execute callbacks de teste em carteiras reais."
    },
    {
      "name": "Callback REFUND",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          },
          {
            "key": "Accept",
            "value": "application/json"
          }
        ],
        "body": {
          "mode": "raw",
          "raw": "{\n  \"type\": \"REFUND\",\n  \"game_type\": \"slot\",\n  \"user_code\": \"{{user_code}}\",\n  \"agent_code\": \"SEU_AGENT_CODE\",\n  \"agent_secret\": \"SEU_AGENT_SECRET\",\n  \"user_balance\": 100.50,\n  \"slot\": {\n    \"provider_code\": \"PGSOFTGAMES\",\n    \"game_code\": \"fortune-tiger\",\n    \"type\": \"BASE\",\n    \"bet_money\": 0.00,\n    \"win_money\": 5.00,\n    \"txn_id\": \"TXN_REFUND_UNICO\",\n    \"round_id\": \"ROUND_UNICO\",\n    \"txn_type\": \"refund\",\n    \"user_before_balance\": 95.50,\n    \"user_after_balance\": 100.50,\n    \"timestamp\": \"2026-07-07T14:35:00-03:00\"\n  }\n}"
        },
        "url": {
          "raw": "{{operator_callback_url}}",
          "host": [
            "{{operator_callback_url}}"
          ]
        }
      },
      "description": "Exemplo do envelope legado com type no topo. Não é um modelo universal: transaction/slot de PlayFiver/iGameWin e o Rabbit usam contratos específicos documentados em /developer. Não execute callbacks de teste em carteiras reais."
    },
    {
      "name": "Consulta por ID e comprovante v1 (endpoint do operador)",
      "description": "Obrigatório para novas homologações: somente leitura, assinatura Ed25519 de entrada e HMAC na resposta. Novos agentes usam transaction_status na URL do callback cadastrado, com validação e habilitação automáticas. URLs dedicadas existentes são preservadas. Contratos existentes preservados. Gere as assinaturas no backend; não coloque chave privada nesta coleção.",
      "item": [
        {
          "name": "Consultar operação original — modelo de homologação protegido",
          "event": [
            {
              "listen": "prerequest",
              "script": {
                "type": "text/javascript",
                "exec": [
                  "if (pm.variables.get(\"enable_reconciliation_lookup\") !== \"true\") { throw new Error(\"Modelo de homologação desativado. Homologue o endpoint e gere os cabeçalhos de assinatura antes de habilitar.\"); }",
                  "const requiredHeaders = [\"dtg_signature\", \"dtg_key_id\", \"dtg_timestamp\", \"dtg_nonce\", \"dtg_audience\"];",
                  "if (requiredHeaders.some(key => !pm.variables.get(key))) { throw new Error(\"Gere no backend os cinco cabeçalhos de assinatura antes de consultar o sandbox homologado.\"); }"
                ]
              }
            }
          ],
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              },
              {
                "key": "X-DTG-Signature",
                "value": "{{dtg_signature}}"
              },
              {
                "key": "X-DTG-Key-Id",
                "value": "{{dtg_key_id}}"
              },
              {
                "key": "X-DTG-Timestamp",
                "value": "{{dtg_timestamp}}"
              },
              {
                "key": "X-DTG-Nonce",
                "value": "{{dtg_nonce}}"
              },
              {
                "key": "X-DTG-Audience",
                "value": "{{dtg_audience}}"
              }
            ],
            "url": "{{operator_reconciliation_url}}",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"version\": \"dtg-reconciliation-v1\",\n  \"method\": \"transaction_status\",\n  \"request_id\": \"{{reconciliation_request_id}}\",\n  \"transaction\": {\n    \"agent_code\": \"{{agent_code}}\",\n    \"user_code\": \"{{user_code}}\",\n    \"txn_id\": \"{{original_txn_id}}\",\n    \"provider_code\": \"DREAMTECHGAMES\",\n    \"game_code\": \"fortune-snake\",\n    \"currency\": \"BRL\",\n    \"bet_cents\": 50,\n    \"win_cents\": 250\n  }\n}"
            }
          },
          "description": "IDs são strings; bet_cents e win_cents são inteiros e aceitam zero. Não enviar slot, saldo ou agent_secret no corpo da consulta. A resposta aplicada deve incluir recibo durável e assinatura vinculada ao request_id. O modelo não gera assinaturas automaticamente.",
          "response": [
            {
              "name": "Aplicada — comprovante durável (exemplo fictício)",
              "originalRequest": {
                "method": "POST",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  },
                  {
                    "key": "X-DTG-Signature",
                    "value": "{{dtg_signature}}"
                  },
                  {
                    "key": "X-DTG-Key-Id",
                    "value": "{{dtg_key_id}}"
                  },
                  {
                    "key": "X-DTG-Timestamp",
                    "value": "{{dtg_timestamp}}"
                  },
                  {
                    "key": "X-DTG-Nonce",
                    "value": "{{dtg_nonce}}"
                  },
                  {
                    "key": "X-DTG-Audience",
                    "value": "{{dtg_audience}}"
                  }
                ],
                "url": "{{operator_reconciliation_url}}",
                "body": {
                  "mode": "raw",
                  "raw": "{\n  \"version\": \"dtg-reconciliation-v1\",\n  \"method\": \"transaction_status\",\n  \"request_id\": \"{{reconciliation_request_id}}\",\n  \"transaction\": {\n    \"agent_code\": \"{{agent_code}}\",\n    \"user_code\": \"{{user_code}}\",\n    \"txn_id\": \"{{original_txn_id}}\",\n    \"provider_code\": \"DREAMTECHGAMES\",\n    \"game_code\": \"fortune-snake\",\n    \"currency\": \"BRL\",\n    \"bet_cents\": 50,\n    \"win_cents\": 250\n  }\n}"
                }
              },
              "status": "OK",
              "code": 200,
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                },
                {
                  "key": "X-DTG-Reconciliation-Signature",
                  "value": "v1:{{hmac_hex_da_resposta_exata}}"
                }
              ],
              "body": "{\n  \"version\": \"dtg-reconciliation-v1\",\n  \"request_id\": \"{{reconciliation_request_id}}\",\n  \"transaction\": {\n    \"agent_code\": \"{{agent_code}}\",\n    \"user_code\": \"{{user_code}}\",\n    \"txn_id\": \"{{original_txn_id}}\",\n    \"provider_code\": \"DREAMTECHGAMES\",\n    \"game_code\": \"fortune-snake\",\n    \"currency\": \"BRL\",\n    \"bet_cents\": 50,\n    \"win_cents\": 250\n  },\n  \"state\": \"applied\",\n  \"receipt_id\": \"lancamento-duravel-exemplo\"\n}"
            }
          ]
        }
      ]
    }
  ]
}
