Obtener transacciones masivas

Devuelve transacciones recientes de hasta 100 usuarios conectados en una sola llamada — como máximo 20 por objetivo, de más nuevas a más antiguas, con un valor predeterminado de los últimos 90 días.

Requisitos

Authorization: Basic <API_KEY> (la clave API de tu aplicación)
La capacidad de API masiva en tu aplicación
Los alcances LIST_PAYMENT y LIST_PURCHASES en la concesión de cada usuario objetivo

Los errores se informan por objetivo y nunca fallan toda la solicitud. Consulta Descripción general de la API masiva para el modelo de direccionamiento y los códigos de error.

Consulta

query GetBulkTransactions(
  $targetSpec: BulkTargetSpecInput!
  $createdGte: DateTime
  $createdLte: DateTime
  $includeMetadata: Boolean
) {
  getBulkTransactions(
    targetSpec: $targetSpec
    createdGte: $createdGte
    createdLte: $createdLte
    includeMetadata: $includeMetadata
  ) {
    targetCount
    successCount
    failureCount
    results {
      externalReferenceId
      accountId
      success
      error { code message }
      totalCount
      hasNextPage
      transactions {
        recordId
        transactionType
        amount
        status
        createdAt
        memo
        transactionCategory
      }
    }
  }
}

Variables

{
  "targetSpec": { "mode": "SELECTED", "targets": ["your-user-001"] },
  "createdGte": null,
  "createdLte": null,
  "includeMetadata": false
}

Respuesta

{
  "data": {
    "getBulkTransactions": {
      "targetCount": 1,
      "successCount": 1,
      "failureCount": 0,
      "results": [
        {
          "externalReferenceId": "your-user-001",
          "accountId": "8f3c…",
          "success": true,
          "error": null,
          "totalCount": 42,
          "hasNextPage": true,
          "transactions": [
            {
              "recordId": "rec-1",
              "transactionType": "GIFT_CARD_PURCHASE",
              "amount": 25.0,
              "status": "SETTLED",
              "createdAt": "2026-07-01T00:00:00.000Z",
              "memo": null,
              "transactionCategory": null
            }
          ]
        }
      ]
    }
  }
}

Argumentos

Argumento	Tipo	Descripción
`targetSpec`	`BulkTargetSpecInput!`	Selección de objetivos. Máximo 100 objetivos. Consulta la Descripción general.
`createdGte`	`DateTime`	Incluir solo transacciones creadas en o después de este momento. De forma predeterminada, 90 días antes de `createdLte`.
`createdLte`	`DateTime`	Incluir solo transacciones creadas en o antes de este momento. De forma predeterminada, ahora.
`includeMetadata`	`Boolean`	También devuelve `memo` y `transactionCategory`. Más lento; el valor predeterminado es `false`.

Campos de la respuesta

Campo	Descripción
`results[].transactions`	Hasta 20 transacciones más recientes en la ventana, de más nuevas a más antiguas. Restringidas a cuentas de gasto permitidas cuando la concesión está limitada por cuenta de gasto.
`results[].totalCount`	Total de transacciones que coinciden con la ventana para este objetivo.
`results[].hasNextPage`	`true` cuando el objetivo tiene más de las 20 devueltas.
`targetCount` / `successCount` / `failureCount`	Resumen a nivel de solicitud.

Límites y cómo obtener el historial completo

20 transacciones por objetivo y una ventana máxima de 90 días por solicitud. Una ventana mayor a 90 días se rechaza — reduce el rango o utiliza la exportación.
Cuando hasNextPage es true o totalCount excede lo devuelto, hay más datos. Esta consulta acotada nunca trunca en silencio; para el historial completo usa la exportación de transacciones asíncrona (próximamente).
includeMetadata: true agrega memo y transactionCategory por transacción con algún costo de latencia. Los enlaces de adjuntos no se incluyen en la ruta masiva — utiliza la exportación para metadatos completos.

​Requisitos

​Consulta

​Variables

​Respuesta

​Argumentos

​Campos de la respuesta

​Límites y cómo obtener el historial completo