Reporte de Transacciones

GET /api/client/reports/transactions

Obtenga una lista paginada de transacciones con filtros opcionales. La respuesta incluye registros individuales de transacciones junto con totales agregados de débitos, créditos, rollbacks, giros gratis y ganancia.

Parámetros de Consulta

Parámetro	Tipo	Requerido	Descripción
page	integer	No	Número de página (por defecto: 1)
filter[per_page]	integer	No	Elementos por página (por defecto: 50)
filter[transaction_type][]	string	No	Filtrar por tipo: DEBIT, CREDIT, ROLLBACK, FREE_SPIN
filter[currency_id]	string	No	Código ISO de moneda (ej., USD, CRC)
filter[fromDate]	string	No	Fecha de inicio en formato YYYY-MM-DD
filter[toDate]	string	No	Fecha de fin en formato YYYY-MM-DD
filter[provider_id][]	integer	No	Filtrar por ID(s) de proveedor

Filtrado por Múltiples Valores

Los parámetros de tipo array (marcados con []) aceptan múltiples valores. Por ejemplo, para filtrar por los tipos DEBIT y CREDIT:

?filter[transaction_type][]=DEBIT&filter[transaction_type][]=CREDIT

Solicitud

Headers

Header	Valor	Requerido
Accept	application/json	Sí
X-Client-Secret	Su UUID secret	Sí

Ejemplo de Solicitud

curl -X GET 'https://api.syssoft1.com/api/client/reports/transactions?page=1&filter[per_page]=50' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Ejemplo con Filtros

curl -X GET 'https://api.syssoft1.com/api/client/reports/transactions?page=1&filter[per_page]=50&filter[transaction_type][]=DEBIT&filter[currency_id]=USD&filter[fromDate]=2026-03-01&filter[toDate]=2026-04-13' \
  -H 'Accept: application/json' \
  -H 'X-Client-Secret: fd5a9710-d7f8-47af-a2c5-d553f9029706'

Respuesta

Respuesta Exitosa — 200 OK

{
  "data": [
    {
      "id": 12345,
      "type": "DEBIT",
      "amount": 10.00,
      "currency": "USD",
      "player": "player123",
      "provider": "Pragmatic Play",
      "game": "Sweet Bonanza",
      "created_at": "2026-04-13 10:30:00"
    }
  ],
  "pagination": {
    "current_page": 1,
    "total": 150,
    "per_page": 50,
    "total_pages": 3
  },
  "totals": {
    "total_debit": {
      "raw": 50000.00,
      "formatted": "$50,000.00",
      "large_number": "50K",
      "count": 1200
    },
    "total_credit": {
      "raw": 45000.00,
      "formatted": "$45,000.00",
      "large_number": "45K",
      "count": 800
    },
    "total_rollback": {
      "raw": 500.00,
      "formatted": "$500.00",
      "large_number": "500",
      "count": 50
    },
    "total_free_spin": {
      "raw": 200.00,
      "formatted": "$200.00",
      "large_number": "200",
      "count": 100
    },
    "profit": {
      "raw": 4300.00,
      "formatted": "$4,300.00",
      "large_number": "4.3K"
    },
    "total_count": 2150
  }
}

Campos de la Respuesta

data[] — Registros de Transacciones

Campo	Tipo	Descripción
id	integer	Identificador único de la transacción
type	string	Tipo de transacción: DEBIT, CREDIT, ROLLBACK o FREE_SPIN
amount	number	Monto de la transacción
currency	string	Código ISO de moneda
player	string	Nombre de usuario del jugador
provider	string	Nombre del proveedor de juegos
game	string	Nombre del juego
created_at	string	Marca de tiempo de la transacción (YYYY-MM-DD HH:mm:ss)

pagination — Información de Paginación

Campo	Tipo	Descripción
current_page	integer	Número de página actual
total	integer	Número total de registros
per_page	integer	Registros por página
total_pages	integer	Número total de páginas

totals — Totales Agregados

El objeto totals proporciona valores agregados de todos los registros que coinciden con los filtros actuales (no solo la página actual). Cada total monetario incluye:

Campo	Tipo	Descripción
raw	number	Valor numérico en crudo
formatted	string	Cadena formateada con símbolo de moneda
large_number	string	Representación abreviada (ej., 50K, 1.2M)
count	integer	Número de transacciones de este tipo

El campo profit se calcula como: total_debit - total_credit - total_rollback.

Pruébelo

⚡API PlaygroundGET

URL Base

X-Client-Secret *

Parámetros

pageinteger

Page number

filter[per_page]integer

Items per page

filter[transaction_type][]array

Transaction types

-- Seleccionar --DEBITCREDITROLLBACKFREE_SPIN

filter[currency_id]string

Currency ISO code

filter[fromDate]string

Start date (YYYY-MM-DD)

filter[toDate]string

End date (YYYY-MM-DD)

filter[provider_id][]array

Provider IDs

URL de Petición

https://api.syssoft1.com/api/client/reports/transactions

Respuestas de Error

Código	Descripción
401	Client secret inválido o inactivo. Consulte Autenticación.
422	Parámetros de consulta inválidos. Verifique los tipos y formatos de los parámetros.
429	Límite de solicitudes excedido. Espere y reintente. Consulte Manejo de Errores.