Developers/Referencia

Gallo Pay API

Referencia generada a partir del spec OpenAPI v1.0. Autenticación por x-api-key. Para la guía de integración (quick start, webhooks, errores) volvé a Developers.

Producción

https://api.gallo-pay.com

Sandbox

https://sandbox.api.gallo-pay.com

Versión

1.0

Índice

accounts

POST/v1/accounts
GET/v1/accounts
GET/v1/accounts/{cvu}
DELETE/v1/accounts/{cvu}
PUT/v1/accounts/{cvu}/alias
GET/v1/accounts/{cvu}/balance
GET/v1/accounts/{cvu}/movements
GET/v1/lookup/cbu/{cbu}
GET/v1/lookup/alias/{alias}

transfers

POST/v1/transfers
GET/v1/transfers
GET/v1/transfers/{id}

stats

GET/v1/stats
GET/v1/stats/timeseries

accounts

CVUs, alias, saldos y movimientos

POST/v1/accounts

Crear CVU (y alias opcional)

Da de alta una CVU para el titular indicado. Requiere Idempotency-Key. Emite el webhook `account.created`.

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateAccountDto · requerido

Campos

Campo	Tipo	Descripción
cuit*	string	ej. "20370994049"
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	—
alias	string	ej. "gallo.juan.perez"

{
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez"
}

Respuesta 201 · AccountResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40"
cvu*	string	CVU generada por el banco (22 dígitos).
cuit*	string	ej. "20370994049"
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	ej. "F"
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| closed)	ej. "active"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40",
  "cvu": "0000208200000000000147",
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez",
  "status": "active",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/accounts

Listar CVUs

Lista paginada de CVUs. `q` busca por CVU, alias, titular o CUIT.

Parámetros

Nombre	En	Tipo	Notas
limit*	query	string	—
offset*	query	string	—
q*	query	string	—

Respuesta 200 · PaginatedAccounts

Campos

Campo	Tipo	Descripción
total*	number	Total de registros que cumplen el filtro.
limit*	number	Tamaño de página aplicado (máx. 100).
offset*	number	Offset actual.
items*	AccountResponse[]	—

{
  "total": 137,
  "limit": 50,
  "offset": 0,
  "items": [
    {
      "id": "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40",
      "cvu": "0000208200000000000147",
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F",
      "alias": "gallo.juan.perez",
      "status": "active",
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/accounts/{cvu}

Obtener CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200 · AccountResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40"
cvu*	string	CVU generada por el banco (22 dígitos).
cuit*	string	ej. "20370994049"
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	ej. "F"
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| closed)	ej. "active"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40",
  "cvu": "0000208200000000000147",
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez",
  "status": "active",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida
404 — CVU inexistente

DELETE/v1/accounts/{cvu}

Dar de baja una CVU

Cierra la CVU. Emite el webhook `account.closed`.

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200 · AccountResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40"
cvu*	string	CVU generada por el banco (22 dígitos).
cuit*	string	ej. "20370994049"
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	ej. "F"
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| closed)	ej. "active"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40",
  "cvu": "0000208200000000000147",
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez",
  "status": "active",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida

PUT/v1/accounts/{cvu}/alias

Crear/actualizar alias de una CVU

Emite el webhook `account.alias.updated`.

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · SetAliasDto · requerido

Campos

Campo	Tipo	Descripción
alias*	string	ej. "gallo.juan.perez"

{
  "alias": "gallo.juan.perez"
}

Respuesta 200 · AccountResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40"
cvu*	string	CVU generada por el banco (22 dígitos).
cuit*	string	ej. "20370994049"
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	ej. "F"
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| closed)	ej. "active"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "3f6d9c1e-8b2a-4a1f-9c3e-6b7a1d2e5f40",
  "cvu": "0000208200000000000147",
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez",
  "status": "active",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida
409 — Alias ya tomado

GET/v1/accounts/{cvu}/balance

Saldo del ledger para una CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200 · BalanceResponse

Campos

Campo	Tipo	Descripción
cvu*	string	ej. "0000208200000000000147"
availableBalance*	string	Saldo disponible para transferir (ARS).
heldBalance*	string	Saldo retenido por transferencias en vuelo (ARS).
totalBalance*	string	availableBalance + heldBalance.

{
  "cvu": "0000208200000000000147",
  "availableBalance": "15230.50",
  "heldBalance": "500.00",
  "totalBalance": "15730.50"
}

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/accounts/{cvu}/movements

Movimientos del ledger para una CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
limit*	query	string	—
offset*	query	string	—

Respuesta 200

[
  {
    "id": "a1b2c3d4-0000-4000-8000-000000000000",
    "cvu": "0000208200000000000147",
    "type": "credit",
    "amount": "1500.00",
    "availableAfter": "15230.50",
    "heldAfter": "0.00",
    "referenceType": "webhook_credit",
    "referenceId": "evt-9f8e7d6c",
    "description": "Cash-in G1LMP68 from 0000208200000000000291",
    "createdAt": "2026-07-30T12:00:00.000Z"
  }
]

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/lookup/cbu/{cbu}

Resolver titular de una CBU/CVU

Parámetros

Nombre	En	Tipo	Notas
cbu*	path	string	—

Respuesta 200

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/lookup/alias/{alias}

Resolver titular de un alias

Parámetros

Nombre	En	Tipo	Notas
alias*	path	string	—

Respuesta 200

Errores

400 — Request inválido
401 — API key ausente o inválida

transfers

Transferencias de salida (cash-out) en ARS

POST/v1/transfers

Crear transferencia de salida (cash-out) en ARS

Registra y envía una transferencia hacia una CBU/CVU destino. Requiere Idempotency-Key. El estado evoluciona pending → sent → confirmed | failed, emitiendo un webhook por cambio.

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateTransferDto · requerido

Campos

Campo	Tipo	Descripción
cvuDebito*	string	ej. "0000208200000000000147"
cbuCredito*	string	ej. "0000208200000000000291"
cuitCredito*	string	ej. "20370994049"
titularCredito	string	ej. "JUAN PEREZ"
concepto*	enum(ALQ \| APC \| BRH \| BRN \| CUO \| ESE \| EXP \| FAC \| HAB \| HON \| OIH \| OIN \| PRE \| ROP \| SEG \| SIS \| SON \| VAR \| PLF)	ej. "VAR"
importe*	number	ej. 1500.5
descripcion	string	ej. "Pago servicio"

{
  "cvuDebito": "0000208200000000000147",
  "cbuCredito": "0000208200000000000291",
  "cuitCredito": "20370994049",
  "titularCredito": "JUAN PEREZ",
  "concepto": "VAR",
  "importe": 1500.5,
  "descripcion": "Pago servicio"
}

Respuesta 201 · TransferResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "7c9e6679-7425-40de-944b-e07fc1f90ae7"
idTrxCliente*	string	ID de transacción correlativo asignado por Gallo Pay.
idTrxCoelsa*	object	ID de la operación en la red de pagos (una vez liquidada).
cvuDebito*	string	ej. "0000208200000000000147"
cuitDebito*	string	ej. "20370994049"
titularDebito*	string	ej. "JUAN PEREZ"
cbuCredito*	string	ej. "0000208200000000000291"
cuitCredito*	string	ej. "20111111112"
titularCredito*	object	ej. "MARIA GOMEZ"
concepto*	string	Concepto BCRA.
importe*	string	ej. "1500.50"
descripcion*	object	ej. "Pago servicio"
status*	enum(pending \| sent \| confirmed \| failed \| reversed)	pending → sent → confirmed \| failed \| reversed. Cada cambio emite un webhook.
errorCoelsa*	object	ej. null
estadoCodigo*	object	ej. "00"
estadoDescripcion*	object	ej. "OK"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "idTrxCliente": "1024",
  "idTrxCoelsa": "G1LMP68NKVYE3XD2R7OEV4",
  "cvuDebito": "0000208200000000000147",
  "cuitDebito": "20370994049",
  "titularDebito": "JUAN PEREZ",
  "cbuCredito": "0000208200000000000291",
  "cuitCredito": "20111111112",
  "titularCredito": "MARIA GOMEZ",
  "concepto": "VAR",
  "importe": "1500.50",
  "descripcion": "Pago servicio",
  "status": "confirmed",
  "errorCoelsa": null,
  "estadoCodigo": "00",
  "estadoDescripcion": "OK",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida
422 — Saldo insuficiente / rechazo de negocio

GET/v1/transfers

Listar transferencias

Lista paginada. Filtrable por `status` y búsqueda libre `q`.

Parámetros

Nombre	En	Tipo	Notas
limit*	query	string	—
offset*	query	string	—
status*	query	string	—
q*	query	string	—

Respuesta 200 · PaginatedTransfers

Campos

Campo	Tipo	Descripción
total*	number	Total de registros que cumplen el filtro.
limit*	number	Tamaño de página aplicado (máx. 100).
offset*	number	Offset actual.
items*	TransferResponse[]	—

{
  "total": 137,
  "limit": 50,
  "offset": 0,
  "items": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "idTrxCliente": "1024",
      "idTrxCoelsa": "G1LMP68NKVYE3XD2R7OEV4",
      "cvuDebito": "0000208200000000000147",
      "cuitDebito": "20370994049",
      "titularDebito": "JUAN PEREZ",
      "cbuCredito": "0000208200000000000291",
      "cuitCredito": "20111111112",
      "titularCredito": "MARIA GOMEZ",
      "concepto": "VAR",
      "importe": "1500.50",
      "descripcion": "Pago servicio",
      "status": "confirmed",
      "errorCoelsa": null,
      "estadoCodigo": "00",
      "estadoDescripcion": "OK",
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

400 — Request inválido
401 — API key ausente o inválida

GET/v1/transfers/{id}

Obtener transferencia por id

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · TransferResponse

Campos

Campo	Tipo	Descripción
id*	string	ej. "7c9e6679-7425-40de-944b-e07fc1f90ae7"
idTrxCliente*	string	ID de transacción correlativo asignado por Gallo Pay.
idTrxCoelsa*	object	ID de la operación en la red de pagos (una vez liquidada).
cvuDebito*	string	ej. "0000208200000000000147"
cuitDebito*	string	ej. "20370994049"
titularDebito*	string	ej. "JUAN PEREZ"
cbuCredito*	string	ej. "0000208200000000000291"
cuitCredito*	string	ej. "20111111112"
titularCredito*	object	ej. "MARIA GOMEZ"
concepto*	string	Concepto BCRA.
importe*	string	ej. "1500.50"
descripcion*	object	ej. "Pago servicio"
status*	enum(pending \| sent \| confirmed \| failed \| reversed)	pending → sent → confirmed \| failed \| reversed. Cada cambio emite un webhook.
errorCoelsa*	object	ej. null
estadoCodigo*	object	ej. "00"
estadoDescripcion*	object	ej. "OK"
createdAt*	string	ej. "2026-07-30T12:00:00.000Z"
updatedAt*	string	ej. "2026-07-30T12:00:00.000Z"

{
  "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "idTrxCliente": "1024",
  "idTrxCoelsa": "G1LMP68NKVYE3XD2R7OEV4",
  "cvuDebito": "0000208200000000000147",
  "cuitDebito": "20370994049",
  "titularDebito": "JUAN PEREZ",
  "cbuCredito": "0000208200000000000291",
  "cuitCredito": "20111111112",
  "titularCredito": "MARIA GOMEZ",
  "concepto": "VAR",
  "importe": "1500.50",
  "descripcion": "Pago servicio",
  "status": "confirmed",
  "errorCoelsa": null,
  "estadoCodigo": "00",
  "estadoDescripcion": "OK",
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

400 — Request inválido
401 — API key ausente o inválida
404 — Transferencia inexistente

stats

GET/v1/stats

Dashboard stats

Respuesta 200

GET/v1/stats/timeseries

Daily transfer volume timeseries

Parámetros

Nombre	En	Tipo	Notas
days*	query	string	—

Respuesta 200