Developers/Referencia

Gallo Pay API

Referencia generada a partir del spec OpenAPI v1.0. Autenticación por x-api-key. Descargá el contrato en /openapi.json o volvé a la guía de Developers.

Homologación / dev

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

Producción

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

Sandbox / homologación

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

Versión

1.0

Índice

accounts

POST/v1/accounts
GET/v1/accounts
GET/v1/accounts/{cvu}
DELETE/v1/accounts/{cvu}
GET/v1/accounts/{cvu}/limits
PATCH/v1/accounts/{cvu}/limits
POST/v1/accounts/{cvu}/suspend
POST/v1/accounts/{cvu}/reactivate
PATCH/v1/accounts/{cvu}/identidad
PATCH/v1/accounts/{cvu}/kyc
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}
POST/v1/accounts/{cvu}/tags
DELETE/v1/accounts/{cvu}/tags/{tag}

transfers

POST/v1/transfers
GET/v1/transfers
GET/v1/transfers/summary
GET/v1/transfers/by-coelsa/{idCoelsa}
GET/v1/transfers/{id}/timeline
GET/v1/transfers/{id}

ledger-comprobantes

GET/v1/voucher-types
POST/v1/voucher-types
PATCH/v1/voucher-types/{code}
DELETE/v1/voucher-types/{code}
GET/v1/accounts/{cvu}/comprobantes
POST/v1/accounts/{cvu}/comprobantes
GET/v1/comprobantes/internal
GET/v1/comprobantes/by-external/{idExterno}
GET/v1/comprobantes/{id}
GET/v1/accounts/{cvu}/balance/historical

agentic

POST/v1/agentic/orders
GET/v1/agentic/orders
GET/v1/agentic/orders/{id}
POST/v1/agentic/orders/{id}/confirm
POST/v1/agentic/orders/{id}/reject
POST/v1/agentic/chat

wallet-cuentas

GET/wallet/v1/Cuentas
POST/wallet/v1/Cuenta
PATCH/wallet/v1/Habilitado/Cuenta/{id}
PUT/wallet/v1/Cuenta/{id}
GET/wallet/v1/Cuenta/{id}
GET/wallet/v1/CuentaByCuit
GET/wallet/v1/CuentaByEmail
GET/wallet/v1/CuentaByCelular

wallet-cvu

POST/wallet/v1/CVU
DELETE/wallet/v1/CVU/{id}
PATCH/wallet/v1/AsignarAlias/CVU/{id}
GET/wallet/v1/CuentaCVUByCbuCvuOrAlias
GET/wallet/v1/CuentasCVU

wallet-saldo

GET/wallet/v1/TiposComprobantes
POST/wallet/v1/TipoComprobante
DELETE/wallet/v1/TipoComprobante/{id}
POST/wallet/v1/Comprobante
GET/wallet/v1/ComprobanteByIdExterno/{idExterno}
GET/wallet/v1/Comprobante/{id}
GET/wallet/v1/SaldoActualByCVU/{cvu}
GET/wallet/v1/SaldoActualByIdCuenta/{idCuenta}
GET/wallet/v1/SaldosActuales
GET/wallet/v1/SaldoHistoricoByCVU/{cvu}
GET/wallet/v1/SaldoHistoricoByIdCuenta/{idCuenta}
GET/wallet/v1/SaldosHistoricos

wallet-conciliar

GET/wallet/v1/ComprobantesByFilters
GET/wallet/v1/MovimientosCuentaCorriente
GET/wallet/v1/Operaciones

bank

GET/v1/bank/conciliacion

wallet-remuneracion

POST/wallet/v1/Remuneracion/Alta
GET/wallet/v1/Remuneracion/Estado/{cvu}

treasury

GET/v1/treasury
GET/v1/treasury/positions
GET/v1/treasury/positions/{cvu}
GET/v1/treasury/positions/{cvu}/movements
GET/v1/treasury/positions/{cvu}/balance/historical

wallet-treasury

GET/wallet/v1/Tesoreria
GET/wallet/v1/SaldosClientes
GET/wallet/v1/SaldoClienteByCVU/{cvu}
GET/wallet/v1/SaldoClienteByIdCuenta/{idCuenta}
GET/wallet/v1/MovimientosCliente
GET/wallet/v1/SaldoClienteHistoricoByCVU/{cvu}

fees

GET/v1/fees/preview

fraud

PUT/v1/accounts/{cvu}/fraud/policies/{code}
DELETE/v1/accounts/{cvu}/fraud/policies/{code}

debin

POST/v1/debin/adhesiones
GET/v1/debin/adhesiones
POST/v1/debin/adhesiones/confirmar
POST/v1/debin/adhesiones/baja
POST/v1/debin/spot
POST/v1/debin/pull
POST/v1/debin/programado
GET/v1/debin/programado
GET/v1/debin/programado/{id}
POST/v1/debin/programado/{id}/refresh
POST/v1/debin/programado/{id}/delete
POST/v1/debin/confirma-debito
POST/v1/debin/contracargo
POST/v1/debin/contracargo-pull
GET/v1/debin
GET/v1/debin/{id}

POST/v1/qr/pay
POST/v1/qr/commerce
POST/v1/qr/cashout
POST/v1/qr/cashout/confirma
POST/v1/qr/billetera
GET/v1/qr
GET/v1/qr/{id}
POST/v1/qr/{id}/contracargo

webhooks

GET/v1/webhook-events
GET/v1/webhook-events/summary

accounts

CVUs, alias, saldos y movimientos (`/v1`)

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"
pep	boolean	Persona expuesta políticamente
postalCode	string	ej. "1425"
documentType	string	ej. "DNI"
documentNumber	string	ej. "30123456"
nationality	string	ej. "AR"
commercialUse	boolean	Uso comercial de la cuenta (Apartado B)

{
  "cuit": "20370994049",
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "alias": "gallo.juan.perez",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false
}

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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	—
status*	query	string	—
sort*	query	string	—
order*	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",
      "titulares": [
        {
          "cuit": "20370994049",
          "titular": "JUAN PEREZ",
          "tipoPersona": "F"
        }
      ],
      "alias": "gallo.juan.perez",
      "status": "active",
      "isTreasury": false,
      "sweepEnabled": true,
      "visibleBalance": "15230.50",
      "ledgerAvailable": "0.00",
      "pep": false,
      "postalCode": "1425",
      "documentType": "DNI",
      "documentNumber": "30123456",
      "nationality": "AR",
      "commercialUse": false,
      "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 (incluye límites efectivos y uso)

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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}/limits

Límites efectivos de una CVU (mismo snapshot que GET account)

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200

Errores

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

PATCH/v1/accounts/{cvu}/limits

Actualizar límites de CVU (null = hereda PSP/plataforma)

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · UpdateLimitsDto · requerido

Campos

Campo	Tipo	Descripción
maxTransferAmount	object	Máximo por operación ARS. null = hereda.
dailyTransferLimit	object	Tope diario ARS. null = hereda.
monthlyTransferLimit	object	Tope mensual ARS. null = hereda.
commissionPercent	object	Comisión % override. null = hereda PSP/comprobante.
commissionFixed	object	Comisión fija ARS override. null = hereda PSP/comprobante.

{
  "maxTransferAmount": {},
  "dailyTransferLimit": {},
  "monthlyTransferLimit": {},
  "commissionPercent": {},
  "commissionFixed": {}
}

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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

POST/v1/accounts/{cvu}/suspend

Suspender CVU (bloquea salientes; cash-in sigue)

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · SuspendAccountDto · requerido

Campos

Campo	Tipo	Descripción
reason	string	ej. "Revisión de compliance"

{
  "reason": "Revisión de compliance"
}

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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

POST/v1/accounts/{cvu}/reactivate

Reactivar CVU suspendida

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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

PATCH/v1/accounts/{cvu}/identidad

Actualizar titular / tipo persona / cotitulares

Sincroniza titular y tipoPersona con la entidad financiera. Cotitulares se persisten en Gallo (SIRCUPA). titulares[0] debe ser el CUIT de la CVU.

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · UpdateAccountIdentidadDto · requerido

Campos

Campo	Tipo	Descripción
titular*	string	ej. "JUAN PEREZ"
tipoPersona*	enum(F \| J)	ej. "F"
titulares*	TitularIdentidadDto[]	Lista completa de titulares. [0] debe coincidir con el CUIT de la CVU (titular principal).

{
  "titular": "JUAN PEREZ",
  "tipoPersona": "F",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ]
}

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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

PATCH/v1/accounts/{cvu}/kyc

Actualizar datos KYC / Padrón BCRA de una CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · UpdateAccountKycDto · requerido

Campos

Campo	Tipo	Descripción
pep	object	ej. false
postalCode	string	ej. "1425"
documentType	string	ej. "DNI"
documentNumber	string	ej. "30123456"
nationality	string	ej. "AR"
commercialUse	boolean	ej. false

{
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false
}

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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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"
titulares	unknown[]	Titulares / cotitulares (SIRCUPA). [0] = titular principal.
alias*	object	Alias CBU, null si no fue asignado.
status*	enum(active \| suspended \| closed)	ej. "active"
isTreasury*	boolean	true si esta CVU es tesorería (`tenants.treasuryCvu`) o recaudadora de comisiones (`tenants.commissionCvu`).
sweepEnabled	boolean	PSP con modo sweep (CVU primera recaudadora) activo.
visibleBalance	object	Saldo visible: posición cliente si sweep+usuario; ledger si tesorería o modo standard.
ledgerAvailable	object	Ledger disponible de la CVU (≈0 en usuario con sweep). Solo útil con sweep.
pep*	object	ej. false
postalCode*	object	ej. "1425"
documentType*	object	ej. "DNI"
documentNumber*	object	ej. "30123456"
nationality*	object	ej. "AR"
commercialUse*	boolean	ej. false
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",
  "titulares": [
    {
      "cuit": "20370994049",
      "titular": "JUAN PEREZ",
      "tipoPersona": "F"
    }
  ],
  "alias": "gallo.juan.perez",
  "status": "active",
  "isTreasury": false,
  "sweepEnabled": true,
  "visibleBalance": "15230.50",
  "ledgerAvailable": "0.00",
  "pep": false,
  "postalCode": "1425",
  "documentType": "DNI",
  "documentNumber": "30123456",
  "nationality": "AR",
  "commercialUse": false,
  "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). En modo sweep (CVU usuario) = posición cliente.
heldBalance*	string	Saldo retenido por transferencias en vuelo (ARS).
totalBalance*	string	availableBalance + heldBalance.
mode	enum(standard \| sweep)	—
treasuryCvu	object	—
cvuAvailableBalance	string	Ledger disponible real de la CVU (≈0 si sweep + usuario).
customerLiabilities	object	Pasivo total de clientes (solo CVU tesorería).
freeBalance	object	treasuryAvailable - customerLiabilities (informativo; puede ser negativo).
isTreasury	boolean	true si esta CVU es tesorería o recaudadora de comisiones del PSP.

{
  "cvu": "0000208200000000000147",
  "availableBalance": "15230.50",
  "heldBalance": "500.00",
  "totalBalance": "15730.50",
  "mode": "standard",
  "treasuryCvu": {},
  "cvuAvailableBalance": "string",
  "customerLiabilities": {},
  "freeBalance": {},
  "isTreasury": true
}

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	—
type*	query	string	—
from*	query	string	—
to*	query	string	—
q*	query	string	—
sort*	query	string	—
order*	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

POST/v1/accounts/{cvu}/tags

Add segment tag to CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · AccountTagDto · requerido

Campos

Campo	Tipo	Descripción
tag*	string	ej. "vip"

{
  "tag": "vip"
}

Respuesta 201

DELETE/v1/accounts/{cvu}/tags/{tag}

Remove segment tag from CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
tag*	path	string	—

Respuesta 200

transfers

Transferencias de salida / P2P interno (`/v1`)

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"
isInternal*	boolean	true = liquidada solo con comprobantes de ledger (CVU→CVU mismo PSP).
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",
  "isInternal": false,
  "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	—
desde*	query	string	—
hasta*	query	string	—
cvu*	query	string	—
importeMin*	query	string	—
importeMax*	query	string	—
sort*	query	string	—
order*	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",
      "isInternal": false,
      "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/summary

KPIs de transferencias según filtros

Totales, desglose por estado y top CUIT destino para el mismo filtro que el listado (status, q, desde, hasta, tenantId).

Parámetros

Nombre	En	Tipo	Notas
status*	query	string	—
q*	query	string	—
desde*	query	string	—
hasta*	query	string	—
cvu*	query	string	—
importeMin*	query	string	—
importeMax*	query	string	—

Respuesta 200

Errores

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

GET/v1/transfers/by-coelsa/{idCoelsa}

Buscar cash-out o cash-in por id la red de pagos

Reemplazo de ConciliarTransferenciaEntrante. 404 = no hay operación en este tenant (no es error de integración). Prioridad: transfer local → aviso de crédito → la entidad financiera.

Parámetros

Nombre	En	Tipo	Notas
idCoelsa*	path	string	—

Respuesta 200 · CoelsaLookupResponse

Campos

Campo	Tipo	Descripción
idCoelsa*	string	ej. "G1LMP68NKVYE3XD2R7OEV4"
source*	enum(transfer \| cash_in \| coinag)	transfer = cash-out local; cash_in = aviso de crédito; la entidad financiera = banco, sin fila Gallo.
transfer	object	—
cashIn	object	—
bank	object	Detalle la entidad financiera cuando no hay fila local.

{
  "idCoelsa": "G1LMP68NKVYE3XD2R7OEV4",
  "source": "transfer",
  "transfer": {},
  "cashIn": {},
  "bank": {}
}

Errores

400 — Request inválido
401 — API key ausente o inválida
404 — id la red de pagos inexistente en este tenant

GET/v1/transfers/{id}/timeline

Timeline de estados de una transferencia

Trace completo con timestamps, deltas en ms y estados (pending → sent → confirmed | failed | reversed) incluyendo respuestas del banco y reconciliaciones.

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—
format*	query	string	—

Respuesta 200 · TransferTimelineResponse

Campos

Campo	Tipo	Descripción
transferId*	string	—
idTrxCliente*	string	—
status*	string	—
createdAt*	string	—
updatedAt*	string	—
totalElapsedMs*	number	Duración total en ms
transfer*	TransferSnapshot	—
points*	TransferTimelinePoint[]	Línea de tiempo unificada: lifecycle + ledger + audit + webhooks banco + outbox
events*	TransferTimelinePoint[]	—
counts*	object	Conteos por canal

{
  "transferId": "string",
  "idTrxCliente": "string",
  "status": "string",
  "createdAt": "string",
  "updatedAt": "string",
  "totalElapsedMs": 3500,
  "transfer": {
    "id": "string",
    "tenantId": "string",
    "idTrxCliente": "string",
    "idTrxCoelsa": {},
    "bankDebitoId": {},
    "cvuDebito": "string",
    "cuitDebito": "string",
    "titularDebito": "string",
    "cbuCredito": "string",
    "cuitCredito": "string",
    "titularCredito": {},
    "concepto": "string",
    "importe": "string",
    "descripcion": {},
    "status": "string",
    "errorCoelsa": {},
    "estadoCodigo": {},
    "estadoDescripcion": {},
    "createdAt": "string",
    "updatedAt": "string"
  },
  "points": [
    {
      "id": "string",
      "channel": "lifecycle",
      "seq": 1,
      "elapsedMs": 1247,
      "deltaMs": 312,
      "fromStatus": {},
      "toStatus": {},
      "type": "bank_response",
      "source": "bank",
      "estadoCodigo": {},
      "estadoDescripcion": {},
      "message": {},
      "outcome": {},
      "detail": {},
      "at": "string"
    }
  ],
  "events": [
    {
      "id": "string",
      "channel": "lifecycle",
      "seq": 1,
      "elapsedMs": 1247,
      "deltaMs": 312,
      "fromStatus": {},
      "toStatus": {},
      "type": "bank_response",
      "source": "bank",
      "estadoCodigo": {},
      "estadoDescripcion": {},
      "message": {},
      "outcome": {},
      "detail": {},
      "at": "string"
    }
  ],
  "counts": {
    "lifecycle": 6,
    "ledger": 2,
    "audit": 1,
    "bank_webhook": 0,
    "outbound": 2
  }
}

Errores

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

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"
isInternal*	boolean	true = liquidada solo con comprobantes de ledger (CVU→CVU mismo PSP).
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",
  "isInternal": false,
  "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

ledger-comprobantes

Tipos y comprobantes de ledger nativos (`/v1`)

GET/v1/voucher-types

Listar tipos de comprobante

Incluye tipos de sistema (hold/transfer/crédito/etc.) y tipos custom del tenant.

Respuesta 200

[
  {
    "id": {},
    "legacyId": {},
    "tenantId": {},
    "code": "string",
    "name": "string",
    "sense": "credit",
    "active": true,
    "system": true
  }
]

Errores

401 — API key ausente o inválida

POST/v1/voucher-types

Crear tipo de comprobante custom (credit|debit)

Request body · CreateVoucherTypeDto · requerido

Campos

Campo	Tipo	Descripción
code*	string	ej. "PROMO_REINTEGRO"
name*	string	ej. "Reintegro por promoción"
sense*	enum(credit \| debit \| hold \| release \| confirm_hold)	ej. "credit"

{
  "code": "PROMO_REINTEGRO",
  "name": "Reintegro por promoción",
  "sense": "credit"
}

Respuesta 201 · VoucherTypeResponse

Campos

Campo	Tipo	Descripción
id	object	Null for system (built-in) types
legacyId	object	Numeric id for wallet API (custom only)
tenantId	object	—
code*	string	—
name*	string	—
sense*	enum(credit \| debit \| hold \| release \| confirm_hold)	—
active*	boolean	—
system*	boolean	—

{
  "id": {},
  "legacyId": {},
  "tenantId": {},
  "code": "string",
  "name": "string",
  "sense": "credit",
  "active": true,
  "system": true
}

Errores

401 — API key ausente o inválida

PATCH/v1/voucher-types/{code}

Activar/desactivar tipo custom

Parámetros

Nombre	En	Tipo	Notas
code*	path	string	—

Request body · ToggleVoucherTypeDto · requerido

Campos

Campo	Tipo	Descripción
active*	boolean	—

{
  "active": true
}

Respuesta 200

Errores

401 — API key ausente o inválida

DELETE/v1/voucher-types/{code}

Eliminar tipo custom

Parámetros

Nombre	En	Tipo	Notas
code*	path	string	—

Respuesta 204

Errores

401 — API key ausente o inválida

GET/v1/accounts/{cvu}/comprobantes

Listar comprobantes de una CVU

Proyección legible de ledger_movements (sentido, tipo, saldos después).

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
limit*	query	string	—
offset*	query	string	—
type*	query	string	—
referenceType*	query	string	—
from*	query	string	—
to*	query	string	—
q*	query	string	—
sort*	query	string	—
order*	query	string	—

Respuesta 200

[
  {
    "id": "string",
    "cvu": "string",
    "amount": "string",
    "availableAfter": "string",
    "heldAfter": "string",
    "totalAfter": "string",
    "sense": "credit",
    "voucherTypeCode": "string",
    "voucherTypeName": "string",
    "idExterno": "string",
    "referenceType": "string",
    "referenceId": "string",
    "ledgerType": "string",
    "description": {},
    "createdAt": "string"
  }
]

Errores

401 — API key ausente o inválida

POST/v1/accounts/{cvu}/comprobantes

Crear comprobante de ajuste

Solo tipos custom del tenant. Idempotente por idExterno + sentido (credit/debit).

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Request body · CreateComprobanteDto · requerido

Campos

Campo	Tipo	Descripción
voucherTypeCode*	string	Código de tipo de comprobante custom del tenant (no tipos de sistema).
amount*	number	Importe positivo en ARS
idExterno*	string	Id externo del PSP (idempotencia de este ajuste).
description	string	ej. "Promo verano CVU"

{
  "voucherTypeCode": "PROMO_REINTEGRO",
  "amount": 150.5,
  "idExterno": "promo-2026-08-0042",
  "description": "Promo verano CVU"
}

Respuesta 201 · ComprobanteResponse

Campos

Campo	Tipo	Descripción
id*	string	—
cvu*	string	—
amount*	string	—
availableAfter*	string	—
heldAfter*	string	—
totalAfter*	string	—
sense*	enum(credit \| debit \| hold \| release \| confirm_hold)	—
voucherTypeCode*	string	—
voucherTypeName*	string	—
idExterno*	string	—
referenceType*	string	—
referenceId*	string	—
ledgerType*	string	—
description*	object	—
createdAt*	string	—

{
  "id": "string",
  "cvu": "string",
  "amount": "string",
  "availableAfter": "string",
  "heldAfter": "string",
  "totalAfter": "string",
  "sense": "credit",
  "voucherTypeCode": "string",
  "voucherTypeName": "string",
  "idExterno": "string",
  "referenceType": "string",
  "referenceId": "string",
  "ledgerType": "string",
  "description": {},
  "createdAt": "string"
}

Errores

401 — API key ausente o inválida

GET/v1/comprobantes/internal

Listar comprobantes internos (global)

Ajustes manuales y liquidaciones P2P internas (INTERNAL_P2P_IN/OUT) de todas las CVU, paginado.

Parámetros

Nombre	En	Tipo	Notas
limit*	query	string	—
offset*	query	string	—
desde*	query	string	—
hasta*	query	string	—
cvu*	query	string	—
tipo*	query	string	—
importeMin*	query	string	—
importeMax*	query	string	—
sort*	query	string	—
order*	query	string	—

Respuesta 200

Errores

401 — API key ausente o inválida

GET/v1/comprobantes/by-external/{idExterno}

Consultar ajuste por idExterno

Solo comprobantes de tipo adjustment.

Parámetros

Nombre	En	Tipo	Notas
idExterno*	path	string	—

Respuesta 200 · ComprobanteResponse

Campos

Campo	Tipo	Descripción
id*	string	—
cvu*	string	—
amount*	string	—
availableAfter*	string	—
heldAfter*	string	—
totalAfter*	string	—
sense*	enum(credit \| debit \| hold \| release \| confirm_hold)	—
voucherTypeCode*	string	—
voucherTypeName*	string	—
idExterno*	string	—
referenceType*	string	—
referenceId*	string	—
ledgerType*	string	—
description*	object	—
createdAt*	string	—

{
  "id": "string",
  "cvu": "string",
  "amount": "string",
  "availableAfter": "string",
  "heldAfter": "string",
  "totalAfter": "string",
  "sense": "credit",
  "voucherTypeCode": "string",
  "voucherTypeName": "string",
  "idExterno": "string",
  "referenceType": "string",
  "referenceId": "string",
  "ledgerType": "string",
  "description": {},
  "createdAt": "string"
}

Errores

401 — API key ausente o inválida

GET/v1/comprobantes/{id}

Consultar comprobante por ID interno

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · ComprobanteResponse

Campos

Campo	Tipo	Descripción
id*	string	—
cvu*	string	—
amount*	string	—
availableAfter*	string	—
heldAfter*	string	—
totalAfter*	string	—
sense*	enum(credit \| debit \| hold \| release \| confirm_hold)	—
voucherTypeCode*	string	—
voucherTypeName*	string	—
idExterno*	string	—
referenceType*	string	—
referenceId*	string	—
ledgerType*	string	—
description*	object	—
createdAt*	string	—

{
  "id": "string",
  "cvu": "string",
  "amount": "string",
  "availableAfter": "string",
  "heldAfter": "string",
  "totalAfter": "string",
  "sense": "credit",
  "voucherTypeCode": "string",
  "voucherTypeName": "string",
  "idExterno": "string",
  "referenceType": "string",
  "referenceId": "string",
  "ledgerType": "string",
  "description": {},
  "createdAt": "string"
}

Errores

401 — API key ausente o inválida

GET/v1/accounts/{cvu}/balance/historical

Saldo histórico de cierre por fecha (EOD o último movimiento del día)

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
date*	query	string	—

Respuesta 200 · HistoricalBalanceResponse

Campos

Campo	Tipo	Descripción
cvu*	string	—
date*	string	ej. "2026-08-03"
availableBalance*	string	—
heldBalance*	string	—
totalBalance*	string	—
source*	enum(snapshot \| movement \| zero)	Origen del valor histórico

{
  "cvu": "string",
  "date": "2026-08-03",
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string",
  "source": "snapshot"
}

Errores

401 — API key ausente o inválida

agentic

Órdenes de cash-out agénticas: propose → confirm humano → rail (`/v1`)

POST/v1/agentic/orders

Proponer orden de cash-out agéntica (no mueve fondos)

El LLM (o gallo-api) crea una orden persistida. La política corre en código. Confirmá con POST …/confirm usando payloadHash de GET, no del chat. Cash-out one-shot sigue siendo POST /v1/transfers.

Request body · ProposeAgenticOrderDto · requerido

Campos

Campo	Tipo	Descripción
cvuDebito*	string	ej. "0000208200000000000147"
cbuCredito*	string	ej. "0000208200000000000291"
cuitCredito*	string	ej. "20370994049"
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
titularCredito	string	ej. "JUAN PEREZ"
descripcion	string	ej. "Pago servicio"
intentRaw	string	Texto original del usuario (P5). No se usa para ejecutar.

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

Errores

GET/v1/agentic/orders

Listar órdenes agénticas del tenant

Parámetros

Nombre	En	Tipo	Notas
status*	query	string	—
kind*	query	string	—
origin*	query	string	—
limit*	query	string	—
offset*	query	string	—

Respuesta 200

Errores

GET/v1/agentic/orders/{id}

Ver orden (fuente de verdad para confirmar — no el texto del LLM)

Key agent o human (`agentic.read`). No exige confirm. La card en Sigil lee payloadHash de acá.

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200

Errores

POST/v1/agentic/orders/{id}/confirm

Confirmar orden y ejecutar el servicio de dominio (por kind)

JWT: MFA aal2. API key Sigil: payloadHash + confirmedBy. transfer → TransfersService; suspend/reactivate → AccountsService; debin_spot / qr_commerce → Debin/Qr. No es tool MCP.

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Request body · ConfirmAgenticOrderDto · requerido

Campos

Campo	Tipo	Descripción
payloadHash*	string	SHA-256 hex of the canonical payload from GET /v1/agentic/orders/:id — never from LLM text
confirmedBy	string	Required for API keys: identifier of the human who confirmed (email / user id in Sigil).

{
  "payloadHash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "confirmedBy": "trader@sigil.example"
}

Respuesta 201

Errores

POST/v1/agentic/orders/{id}/reject

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Request body · RejectAgenticOrderDto · requerido

Campos

Campo	Tipo	Descripción
reason	string	—

{
  "reason": "string"
}

Respuesta 201

Errores

POST/v1/agentic/chat

Chat operativo PSP (lecturas L0 + propose L2/L3; no ejecuta)

Saldo, límites, movimientos, freeze/DEBIN/QR/transfer como órdenes. Confirmá con POST /v1/agentic/orders/:id/confirm (key human). cvuDebito del body queda pineado para débito/vendedor por defecto.

Request body · AgenticChatDto · requerido

Campos

Campo	Tipo	Descripción
message*	string	ej. "Mandale 50k a Guido"
cvuDebito*	string	ej. "0000208200000000000147"
threadId	string	—
directory	AgenticDirectoryEntryDto[]	—

{
  "message": "Mandale 50k a Guido",
  "cvuDebito": "0000208200000000000147",
  "threadId": "string",
  "directory": [
    {
      "name": "Guido",
      "cbu": "string",
      "cvu": "string",
      "cuit": "string",
      "alias": "string"
    }
  ]
}

Errores

wallet-cuentas

Cuentas wallet (`/wallet/v1`)

GET/wallet/v1/Cuentas

Listar cuentas wallet

Paginado. `q` filtra por CUIT, email, nombre, código o id.

Parámetros

Nombre	En	Tipo	Notas
pageNumber*	query	string	—
pageSize*	query	string	—
q*	query	string	—
habilitado*	query	string	—
sort*	query	string	—
order*	query	string	—

Respuesta 200 · CuentasListResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
items*	WalletAccountDetailResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "items": [
    {
      "id": 0,
      "tenantId": "string",
      "codigo": {},
      "cuitCuil": "string",
      "nombre": "string",
      "apellido": "string",
      "razonSocial": "string",
      "email": "string",
      "celular": "string",
      "actividadAfip": "string",
      "idOrganizacion": {},
      "habilitado": true,
      "cvu": {},
      "alias": {},
      "nombreCvu": {},
      "domicilio": {
        "calle": {},
        "numero": {},
        "piso": {},
        "departamento": {},
        "localidadCodigo": {},
        "provinciaCodigo": {},
        "cp": {},
        "cpa": {},
        "localidadNombre": {},
        "provinciaNombre": {},
        "pais": {}
      },
      "cuentaCVUId": {},
      "cvus": [
        {
          "id": 0,
          "cvu": "string",
          "alias": {},
          "nombreCvu": {},
          "fechaAlta": "string"
        }
      ],
      "esPep": true,
      "esFatca": true,
      "esUif": true,
      "organizacionCuentaBancoId": {},
      "fechaNacimiento": {},
      "ocupacion": {},
      "estadoCivil": {},
      "dni": {},
      "tipoPersona": "F",
      "nacionalidad": "AR",
      "sujetoObligado": {},
      "nse": {},
      "nivelRiesgo": {},
      "perfilTransaccional": {},
      "ingresosAnuales": {},
      "montoAnualInvertir": {},
      "pepDetalle": {},
      "fechaAltaSiscri": {},
      "fechaMonitoreada": {}
    }
  ]
}

Errores

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

POST/wallet/v1/Cuenta

Crear cuenta wallet

Request body · CreateWalletAccountDto · requerido

Campos

Campo	Tipo	Descripción
codigo	string	—
cuitCuil*	string	ej. "20374315679"
nombre*	string	—
apellido*	string	—
razonSocial*	string	—
email*	string	—
celular*	string	—
actividadAfip*	string	ej. "000012"
habilitado	boolean	—
domicilio	DomicilioDto	—
datosDomicilio	DomicilioDto	—
esPep*	boolean	—
esFatca	boolean	—
esFacta	boolean	—
esUif*	boolean	—
nacionalidad*	string	ej. "AR"
fechaNacimiento	string	—
ocupacion	string	—
estadoCivil	string	—
dni	string	—
tipoPersona	enum(F \| J)	—
sujetoObligado	object	—
nse	object	Nivel socioeconómico (Regis NSE)
nivelRiesgo	object	—
perfilTransaccional	object	—
ingresosAnuales	object	Facturación / ingresos anuales estimados
montoAnualInvertir	object	—
pepDetalle	object	Detalle declaración PEP (parentesco, función, fechas)

{
  "codigo": "string",
  "cuitCuil": "20374315679",
  "nombre": "string",
  "apellido": "string",
  "razonSocial": "string",
  "email": "string",
  "celular": "string",
  "actividadAfip": "000012",
  "habilitado": true,
  "domicilio": {
    "calle": "string",
    "numero": "string",
    "piso": {},
    "departamento": {},
    "localidadCodigo": {},
    "provinciaCodigo": {},
    "localidadId": 0,
    "provinciaId": 0,
    "cp": "string",
    "localidadNombre": {},
    "provinciaNombre": {},
    "pais": {}
  },
  "datosDomicilio": {
    "calle": "string",
    "numero": "string",
    "piso": {},
    "departamento": {},
    "localidadCodigo": {},
    "provinciaCodigo": {},
    "localidadId": 0,
    "provinciaId": 0,
    "cp": "string",
    "localidadNombre": {},
    "provinciaNombre": {},
    "pais": {}
  },
  "esPep": true,
  "esFatca": true,
  "esFacta": true,
  "esUif": true,
  "nacionalidad": "AR",
  "fechaNacimiento": "string",
  "ocupacion": "string",
  "estadoCivil": "string",
  "dni": "string",
  "tipoPersona": "F",
  "sujetoObligado": {},
  "nse": {},
  "nivelRiesgo": {},
  "perfilTransaccional": {},
  "ingresosAnuales": {},
  "montoAnualInvertir": {},
  "pepDetalle": {}
}

Respuesta 201 · CreateWalletAccountResponse

Campos

Campo	Tipo	Descripción
id*	number	ej. 274926
habilitado*	boolean	ej. true

{
  "id": 274926,
  "habilitado": true
}

Errores

400 — Request inválido
401 — API key ausente o inválida
409 — Código ya existe

PATCH/wallet/v1/Habilitado/Cuenta/{id}

Habilitar/deshabilitar cuenta

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Request body · SetHabilitadoDto · requerido

Campos

Campo	Tipo	Descripción
habilitado*	boolean	—

{
  "habilitado": true
}

Respuesta 204

Errores

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

PUT/wallet/v1/Cuenta/{id}

Modificar cuenta

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Request body · UpdateWalletAccountDto · requerido

Campos

Campo	Tipo	Descripción
codigo	string	—
cuitCuil*	string	ej. "20374315679"
nombre*	string	—
apellido*	string	—
razonSocial*	string	—
email*	string	—
celular*	string	—
actividadAfip*	string	ej. "000012"
habilitado	boolean	—
domicilio	DomicilioDto	—
datosDomicilio	DomicilioDto	—
esPep*	boolean	—
esFatca	boolean	—
esFacta	boolean	—
esUif*	boolean	—
nacionalidad*	string	ej. "AR"
fechaNacimiento	string	—
ocupacion	string	—
estadoCivil	string	—
dni	string	—
tipoPersona	enum(F \| J)	—
sujetoObligado	object	—
nse	object	Nivel socioeconómico (Regis NSE)
nivelRiesgo	object	—
perfilTransaccional	object	—
ingresosAnuales	object	Facturación / ingresos anuales estimados
montoAnualInvertir	object	—
pepDetalle	object	Detalle declaración PEP (parentesco, función, fechas)

{
  "codigo": "string",
  "cuitCuil": "20374315679",
  "nombre": "string",
  "apellido": "string",
  "razonSocial": "string",
  "email": "string",
  "celular": "string",
  "actividadAfip": "000012",
  "habilitado": true,
  "domicilio": {
    "calle": "string",
    "numero": "string",
    "piso": {},
    "departamento": {},
    "localidadCodigo": {},
    "provinciaCodigo": {},
    "localidadId": 0,
    "provinciaId": 0,
    "cp": "string",
    "localidadNombre": {},
    "provinciaNombre": {},
    "pais": {}
  },
  "datosDomicilio": {
    "calle": "string",
    "numero": "string",
    "piso": {},
    "departamento": {},
    "localidadCodigo": {},
    "provinciaCodigo": {},
    "localidadId": 0,
    "provinciaId": 0,
    "cp": "string",
    "localidadNombre": {},
    "provinciaNombre": {},
    "pais": {}
  },
  "esPep": true,
  "esFatca": true,
  "esFacta": true,
  "esUif": true,
  "nacionalidad": "AR",
  "fechaNacimiento": "string",
  "ocupacion": "string",
  "estadoCivil": "string",
  "dni": "string",
  "tipoPersona": "F",
  "sujetoObligado": {},
  "nse": {},
  "nivelRiesgo": {},
  "perfilTransaccional": {},
  "ingresosAnuales": {},
  "montoAnualInvertir": {},
  "pepDetalle": {}
}

Respuesta 204

Errores

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

GET/wallet/v1/Cuenta/{id}

Consultar cuenta por ID

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Respuesta 200 · WalletAccountDetailResponse

Campos

Campo	Tipo	Descripción
id*	number	—
tenantId	string	Tenant (PSP) owner
codigo	object	—
cuitCuil*	string	—
nombre*	string	—
apellido*	string	—
razonSocial*	string	—
email*	string	—
celular*	string	—
actividadAfip*	string	—
idOrganizacion	object	—
habilitado*	boolean	—
cvu	object	—
alias	object	—
nombreCvu	object	—
domicilio*	DomicilioResponse	—
cuentaCVUId	object	—
cvus	WalletCvuSummaryResponse[]	Todos los CVUs activos de la wallet. cvu/alias/cuentaCVUId apuntan al primario (más antiguo).
esPep*	boolean	—
esFatca*	boolean	—
esUif*	boolean	—
organizacionCuentaBancoId	object	—
fechaNacimiento	object	—
ocupacion	object	—
estadoCivil	object	—
dni	object	—
tipoPersona	enum(F \| J)	—
nacionalidad*	string	ej. "AR"
sujetoObligado	object	—
nse	object	—
nivelRiesgo	object	—
perfilTransaccional	object	—
ingresosAnuales	object	Facturación / ingresos anuales estimados
montoAnualInvertir	object	—
pepDetalle	object	—
fechaAltaSiscri	object	—
fechaMonitoreada	object	—

{
  "id": 0,
  "tenantId": "string",
  "codigo": {},
  "cuitCuil": "string",
  "nombre": "string",
  "apellido": "string",
  "razonSocial": "string",
  "email": "string",
  "celular": "string",
  "actividadAfip": "string",
  "idOrganizacion": {},
  "habilitado": true,
  "cvu": {},
  "alias": {},
  "nombreCvu": {},
  "domicilio": {
    "calle": {},
    "numero": {},
    "piso": {},
    "departamento": {},
    "localidadCodigo": {},
    "provinciaCodigo": {},
    "cp": {},
    "cpa": {},
    "localidadNombre": {},
    "provinciaNombre": {},
    "pais": {}
  },
  "cuentaCVUId": {},
  "cvus": [
    {
      "id": 0,
      "cvu": "string",
      "alias": {},
      "nombreCvu": {},
      "fechaAlta": "string"
    }
  ],
  "esPep": true,
  "esFatca": true,
  "esUif": true,
  "organizacionCuentaBancoId": {},
  "fechaNacimiento": {},
  "ocupacion": {},
  "estadoCivil": {},
  "dni": {},
  "tipoPersona": "F",
  "nacionalidad": "AR",
  "sujetoObligado": {},
  "nse": {},
  "nivelRiesgo": {},
  "perfilTransaccional": {},
  "ingresosAnuales": {},
  "montoAnualInvertir": {},
  "pepDetalle": {},
  "fechaAltaSiscri": {},
  "fechaMonitoreada": {}
}

Errores

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

GET/wallet/v1/CuentaByCuit

Consultar cuentas por CUIT

Parámetros

Nombre	En	Tipo	Notas
cuit*	query	string	—

Respuesta 200

[
  {
    "id": 0,
    "tenantId": "string",
    "codigo": {},
    "cuitCuil": "string",
    "nombre": "string",
    "apellido": "string",
    "razonSocial": "string",
    "email": "string",
    "celular": "string",
    "actividadAfip": "string",
    "idOrganizacion": {},
    "habilitado": true,
    "cvu": {},
    "alias": {},
    "nombreCvu": {},
    "domicilio": {
      "calle": {},
      "numero": {},
      "piso": {},
      "departamento": {},
      "localidadCodigo": {},
      "provinciaCodigo": {},
      "cp": {},
      "cpa": {},
      "localidadNombre": {},
      "provinciaNombre": {},
      "pais": {}
    },
    "cuentaCVUId": {},
    "cvus": [
      {
        "id": 0,
        "cvu": "string",
        "alias": {},
        "nombreCvu": {},
        "fechaAlta": "string"
      }
    ],
    "esPep": true,
    "esFatca": true,
    "esUif": true,
    "organizacionCuentaBancoId": {},
    "fechaNacimiento": {},
    "ocupacion": {},
    "estadoCivil": {},
    "dni": {},
    "tipoPersona": "F",
    "nacionalidad": "AR",
    "sujetoObligado": {},
    "nse": {},
    "nivelRiesgo": {},
    "perfilTransaccional": {},
    "ingresosAnuales": {},
    "montoAnualInvertir": {},
    "pepDetalle": {},
    "fechaAltaSiscri": {},
    "fechaMonitoreada": {}
  }
]

Errores

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

GET/wallet/v1/CuentaByEmail

Consultar cuentas por email

Parámetros

Nombre	En	Tipo	Notas
email*	query	string	—

Respuesta 200

[
  {
    "id": 0,
    "tenantId": "string",
    "codigo": {},
    "cuitCuil": "string",
    "nombre": "string",
    "apellido": "string",
    "razonSocial": "string",
    "email": "string",
    "celular": "string",
    "actividadAfip": "string",
    "idOrganizacion": {},
    "habilitado": true,
    "cvu": {},
    "alias": {},
    "nombreCvu": {},
    "domicilio": {
      "calle": {},
      "numero": {},
      "piso": {},
      "departamento": {},
      "localidadCodigo": {},
      "provinciaCodigo": {},
      "cp": {},
      "cpa": {},
      "localidadNombre": {},
      "provinciaNombre": {},
      "pais": {}
    },
    "cuentaCVUId": {},
    "cvus": [
      {
        "id": 0,
        "cvu": "string",
        "alias": {},
        "nombreCvu": {},
        "fechaAlta": "string"
      }
    ],
    "esPep": true,
    "esFatca": true,
    "esUif": true,
    "organizacionCuentaBancoId": {},
    "fechaNacimiento": {},
    "ocupacion": {},
    "estadoCivil": {},
    "dni": {},
    "tipoPersona": "F",
    "nacionalidad": "AR",
    "sujetoObligado": {},
    "nse": {},
    "nivelRiesgo": {},
    "perfilTransaccional": {},
    "ingresosAnuales": {},
    "montoAnualInvertir": {},
    "pepDetalle": {},
    "fechaAltaSiscri": {},
    "fechaMonitoreada": {}
  }
]

Errores

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

GET/wallet/v1/CuentaByCelular

Consultar cuentas por celular

Parámetros

Nombre	En	Tipo	Notas
celular*	query	string	—

Respuesta 200

[
  {
    "id": 0,
    "tenantId": "string",
    "codigo": {},
    "cuitCuil": "string",
    "nombre": "string",
    "apellido": "string",
    "razonSocial": "string",
    "email": "string",
    "celular": "string",
    "actividadAfip": "string",
    "idOrganizacion": {},
    "habilitado": true,
    "cvu": {},
    "alias": {},
    "nombreCvu": {},
    "domicilio": {
      "calle": {},
      "numero": {},
      "piso": {},
      "departamento": {},
      "localidadCodigo": {},
      "provinciaCodigo": {},
      "cp": {},
      "cpa": {},
      "localidadNombre": {},
      "provinciaNombre": {},
      "pais": {}
    },
    "cuentaCVUId": {},
    "cvus": [
      {
        "id": 0,
        "cvu": "string",
        "alias": {},
        "nombreCvu": {},
        "fechaAlta": "string"
      }
    ],
    "esPep": true,
    "esFatca": true,
    "esUif": true,
    "organizacionCuentaBancoId": {},
    "fechaNacimiento": {},
    "ocupacion": {},
    "estadoCivil": {},
    "dni": {},
    "tipoPersona": "F",
    "nacionalidad": "AR",
    "sujetoObligado": {},
    "nse": {},
    "nivelRiesgo": {},
    "perfilTransaccional": {},
    "ingresosAnuales": {},
    "montoAnualInvertir": {},
    "pepDetalle": {},
    "fechaAltaSiscri": {},
    "fechaMonitoreada": {}
  }
]

Errores

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

wallet-cvu

CVU / alias wallet (`/wallet/v1`)

POST/wallet/v1/CVU

Crear CVU para una cuenta wallet

Request body · CreateWalletCvuDto · requerido

Campos

Campo	Tipo	Descripción
idCuenta*	number	ej. 274926
nombreCVU	string	ej. "Juan Alberto Perez"
aliasAutomatico	boolean	—
tipoPersona	enum(F \| J)	Override de tipo de persona. Si no se envía, se infiere del prefijo del CUIT.
permitirAdicional	boolean	Permitir un CVU adicional cuando la wallet ya tiene uno activo. Solo tiene efecto para platform_admin; los PSP lo ignoran.

{
  "idCuenta": 274926,
  "nombreCVU": "Juan Alberto Perez",
  "aliasAutomatico": true,
  "tipoPersona": "F",
  "permitirAdicional": true
}

Respuesta 201 · CreateWalletCvuResponse

Campos

Campo	Tipo	Descripción
id*	number	ej. 154552
cvu*	string	ej. "0000208200000000000147"
alias*	object	ej. "gp.20374315679"
idCuenta*	number	ej. 274926
nombreCvu*	string	ej. "Juan Alberto Perez"

{
  "id": 154552,
  "cvu": "0000208200000000000147",
  "alias": "gp.20374315679",
  "idCuenta": 274926,
  "nombreCvu": "Juan Alberto Perez"
}

Errores

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

DELETE/wallet/v1/CVU/{id}

Eliminar CVU

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Respuesta 204

Errores

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

PATCH/wallet/v1/AsignarAlias/CVU/{id}

Asignar o modificar alias de un CVU

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Request body · AsignarAliasDto · requerido

Campos

Campo	Tipo	Descripción
alias*	string	ej. "Carlitos.perez7896"
idEsCuenta	boolean	—

{
  "alias": "Carlitos.perez7896",
  "idEsCuenta": true
}

Respuesta 204

Errores

400 — Request inválido
401 — API key ausente o inválida
422 — Alias inválido / en uso / 24h

GET/wallet/v1/CuentaCVUByCbuCvuOrAlias

Consultar cuenta por CBU/CVU o alias

Parámetros

Nombre	En	Tipo	Notas
cbuOrCvu*	query	string	—
alias*	query	string	—

Respuesta 200 · CuentaCvuLookupResponse

Campos

Campo	Tipo	Descripción
cuentaId	object	—
cbucvu*	string	—
alias	object	—
cuitCuil	object	—
nombre	object	—
bancoNombre	object	—
tipoCuenta	object	Tipo de cuenta según la red de pagos (p. ej. CVU, CC, CA)
activo*	boolean	—
billeteraId	object	—
nombreCvu	object	—
entidad	object	—
moneda*	string	ej. "ARS"

{
  "cuentaId": {},
  "cbucvu": "string",
  "alias": {},
  "cuitCuil": {},
  "nombre": {},
  "bancoNombre": {},
  "tipoCuenta": "CVU",
  "activo": true,
  "billeteraId": {},
  "nombreCvu": {},
  "entidad": {},
  "moneda": "ARS"
}

Errores

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

GET/wallet/v1/CuentasCVU

Listar cuentas CVU de la entidad

Parámetros

Nombre	En	Tipo	Notas
pageNumber*	query	string	—
pageSize*	query	string	—

Respuesta 200 · CuentasCvuListResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
cuentasCVU*	CuentasCvuItemResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "cuentasCVU": [
    {
      "id": 0,
      "idCuenta": 0,
      "nombre": "string",
      "apellido": "string",
      "cuitCuil": "string",
      "cvu": "string",
      "alias": {},
      "fechaAlta": "string"
    }
  ]
}

Errores

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

wallet-saldo

Saldo en pesos y comprobantes (`/wallet/v1`)

GET/wallet/v1/TiposComprobantes

Listar tipos de comprobante

Respuesta 200

[
  {
    "id": 357,
    "nombre": "string",
    "codigo": "string",
    "descripcion": {},
    "signo": 1,
    "sentido": "credit",
    "habilitado": true
  }
]

Errores

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

POST/wallet/v1/TipoComprobante

Crear tipo de comprobante

signo 1 = crédito, -1 = débito; u opcionalmente sentido credit|debit|hold|release|confirm_hold.

Request body · WalletCreateTipoComprobanteDto · requerido

Campos

Campo	Tipo	Descripción
nombre*	string	ej. "Promo reintegro"
codigo*	string	ej. "PROMO_REINTEGRO"
descripcion	string	ej. "Reintegro por promoción"
signo	enum(1 \| -1)	1 = crédito, -1 = débito
sentido	enum(credit \| debit \| hold \| release \| confirm_hold)	Extensión Gallo; si viene, manda sobre signo
tipoMovimiento	string	Categoría de movimiento (opcional)

{
  "nombre": "Promo reintegro",
  "codigo": "PROMO_REINTEGRO",
  "descripcion": "Reintegro por promoción",
  "signo": 1,
  "sentido": "credit",
  "tipoMovimiento": "001"
}

Respuesta 201 · WalletCreateTipoResponse

Campos

Campo	Tipo	Descripción
id*	number	—

{
  "id": 0
}

Errores

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

DELETE/wallet/v1/TipoComprobante/{id}

Eliminar tipo por legacyId

Parámetros

Nombre	En	Tipo	Notas
id*	path	number	—

Respuesta 204

Errores

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

POST/wallet/v1/Comprobante

Crear comprobante de ajuste sobre idCuenta wallet

Request body · WalletCreateComprobanteDto · requerido

Campos

Campo	Tipo	Descripción
idTipoComprobante	number	Id numérico del tipo de comprobante
codigo	string	Código del tipo (alternativa a idTipoComprobante)
idCuenta*	number	ID cuenta wallet
importe*	number	ej. 100
referencia	string	ej. "Recarga"
idExterno	string	ej. "promo-42"
fechaExterna	string	ej. "2026-08-05"

{
  "idTipoComprobante": 0,
  "codigo": "PROMO_REINTEGRO",
  "idCuenta": 274931,
  "importe": 100,
  "referencia": "Recarga",
  "idExterno": "promo-42",
  "fechaExterna": "2026-08-05"
}

Respuesta 201 · WalletCreateComprobanteResponse

Campos

Campo	Tipo	Descripción
id*	string	UUID del movimiento ledger
saldo*	number	Saldo disponible post-ajuste
availableBalance	string	—
heldBalance	string	—
totalBalance	string	—

{
  "id": "string",
  "saldo": 0,
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string"
}

Errores

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

GET/wallet/v1/ComprobanteByIdExterno/{idExterno}

Consultar comprobante por idExterno

Parámetros

Nombre	En	Tipo	Notas
idExterno*	path	string	—

Respuesta 200 · WalletComprobanteItemResponse

Campos

Campo	Tipo	Descripción
idComprobante*	string	—
idTipoComprobante	object	—
descripcionTipoComprobante*	string	—
idCuenta	object	—
fecha*	string	—
importe*	number	—
signo*	enum(1 \| -1)	—
sentido*	string	—
saldo*	number	—
referencia	object	—
idExterno*	string	—
cvu*	string	—
fechaExterna	object	—

{
  "idComprobante": "string",
  "idTipoComprobante": {},
  "descripcionTipoComprobante": "string",
  "idCuenta": {},
  "fecha": "string",
  "importe": 0,
  "signo": 1,
  "sentido": "string",
  "saldo": 0,
  "referencia": {},
  "idExterno": "string",
  "cvu": "string",
  "fechaExterna": {}
}

Errores

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

GET/wallet/v1/Comprobante/{id}

Consultar comprobante por ID (UUID movimiento)

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · WalletComprobanteItemResponse

Campos

Campo	Tipo	Descripción
idComprobante*	string	—
idTipoComprobante	object	—
descripcionTipoComprobante*	string	—
idCuenta	object	—
fecha*	string	—
importe*	number	—
signo*	enum(1 \| -1)	—
sentido*	string	—
saldo*	number	—
referencia	object	—
idExterno*	string	—
cvu*	string	—
fechaExterna	object	—

{
  "idComprobante": "string",
  "idTipoComprobante": {},
  "descripcionTipoComprobante": "string",
  "idCuenta": {},
  "fecha": "string",
  "importe": 0,
  "signo": 1,
  "sentido": "string",
  "saldo": 0,
  "referencia": {},
  "idExterno": "string",
  "cvu": "string",
  "fechaExterna": {}
}

Errores

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

GET/wallet/v1/SaldoActualByCVU/{cvu}

Saldo actual por CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200 · WalletSaldoResponse

Campos

Campo	Tipo	Descripción
saldo*	number	Saldo disponible
availableBalance	string	—
heldBalance	string	—
totalBalance	string	—
cvu	string	—
idCuenta	number	—

{
  "saldo": 0,
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string",
  "cvu": "string",
  "idCuenta": 0
}

Errores

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

GET/wallet/v1/SaldoActualByIdCuenta/{idCuenta}

Saldo actual por idCuenta wallet

Parámetros

Nombre	En	Tipo	Notas
idCuenta*	path	number	—

Respuesta 200 · WalletSaldoResponse

Campos

Campo	Tipo	Descripción
saldo*	number	Saldo disponible
availableBalance	string	—
heldBalance	string	—
totalBalance	string	—
cvu	string	—
idCuenta	number	—

{
  "saldo": 0,
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string",
  "cvu": "string",
  "idCuenta": 0
}

Errores

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

GET/wallet/v1/SaldosActuales

Listar saldos actuales (cuentas con CVU)

`pageSize` máximo 1000. Paginar hasta `totalPages` — no enviar 1_000_000.

Parámetros

Nombre	En	Tipo	Notas
pageNumber*	query	string	—
pageSize*	query	string	—

Respuesta 200 · WalletSaldosPageResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
items*	WalletSaldoResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "items": [
    {
      "saldo": 0,
      "availableBalance": "string",
      "heldBalance": "string",
      "totalBalance": "string",
      "cvu": "string",
      "idCuenta": 0
    }
  ]
}

Errores

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

GET/wallet/v1/SaldoHistoricoByCVU/{cvu}

Saldo histórico por CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
date*	query	string	—

Respuesta 200 · WalletSaldoHistoricoResponse

Campos

Campo	Tipo	Descripción
saldo*	number	Saldo disponible
availableBalance	string	—
heldBalance	string	—
totalBalance	string	—
cvu	string	—
idCuenta	number	—
date*	string	—
source	enum(snapshot \| movement \| zero)	—

{
  "saldo": 0,
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string",
  "cvu": "string",
  "idCuenta": 0,
  "date": "string",
  "source": "snapshot"
}

Errores

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

GET/wallet/v1/SaldoHistoricoByIdCuenta/{idCuenta}

Saldo histórico por idCuenta

Parámetros

Nombre	En	Tipo	Notas
idCuenta*	path	number	—
date*	query	string	—

Respuesta 200 · WalletSaldoHistoricoResponse

Campos

Campo	Tipo	Descripción
saldo*	number	Saldo disponible
availableBalance	string	—
heldBalance	string	—
totalBalance	string	—
cvu	string	—
idCuenta	number	—
date*	string	—
source	enum(snapshot \| movement \| zero)	—

{
  "saldo": 0,
  "availableBalance": "string",
  "heldBalance": "string",
  "totalBalance": "string",
  "cvu": "string",
  "idCuenta": 0,
  "date": "string",
  "source": "snapshot"
}

Errores

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

GET/wallet/v1/SaldosHistoricos

Listar saldos históricos por fecha

Parámetros

Nombre	En	Tipo	Notas
date*	query	string	—
pageNumber*	query	string	—
pageSize*	query	string	—

Respuesta 200 · WalletSaldosPageResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
items*	WalletSaldoResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "items": [
    {
      "saldo": 0,
      "availableBalance": "string",
      "heldBalance": "string",
      "totalBalance": "string",
      "cvu": "string",
      "idCuenta": 0
    }
  ]
}

Errores

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

wallet-conciliar

Consultas y conciliaciones (`/wallet/v1`)

GET/wallet/v1/ComprobantesByFilters

Listar comprobantes con filtros (conciliación)

`fechaDesde`/`fechaHasta` en yyyy-MM-dd. `pageSize` máximo 100; paginar hasta `totalPages`.

Parámetros

Nombre	En	Tipo	Notas
fechaDesde*	query	string	—
fechaHasta*	query	string	—
pageNumber*	query	string	—
pageSize*	query	string	—
idCuenta*	query	string	—
idTipoComprobante*	query	string	—
codigo*	query	string	—
signo*	query	string	—
orderByDesc*	query	string	—

Respuesta 200 · WalletComprobantesPageResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
comprobantes*	WalletComprobanteItemResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "comprobantes": [
    {
      "idComprobante": "string",
      "idTipoComprobante": {},
      "descripcionTipoComprobante": "string",
      "idCuenta": {},
      "fecha": "string",
      "importe": 0,
      "signo": 1,
      "sentido": "string",
      "saldo": 0,
      "referencia": {},
      "idExterno": "string",
      "cvu": "string",
      "fechaExterna": {}
    }
  ]
}

Errores

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

GET/wallet/v1/MovimientosCuentaCorriente

Movimientos de cuenta corriente por idCuenta o cvu

Parámetros

Nombre	En	Tipo	Notas
idCuenta*	query	string	—
cvu*	query	string	—
pageNumber*	query	string	—
pageSize*	query	string	—
fechaDesde*	query	string	—
fechaHasta*	query	string	—

Respuesta 200 · WalletComprobantesPageResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
comprobantes*	WalletComprobanteItemResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "comprobantes": [
    {
      "idComprobante": "string",
      "idTipoComprobante": {},
      "descripcionTipoComprobante": "string",
      "idCuenta": {},
      "fecha": "string",
      "importe": 0,
      "signo": 1,
      "sentido": "string",
      "saldo": 0,
      "referencia": {},
      "idExterno": "string",
      "cvu": "string",
      "fechaExterna": {}
    }
  ]
}

Errores

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

GET/wallet/v1/Operaciones

Listar operaciones (transfers) del tenant

Parámetros

Nombre	En	Tipo	Notas
pageNumber*	query	string	—
pageSize*	query	string	—
fechaDesde*	query	string	—
fechaHasta*	query	string	—
status*	query	string	—

Respuesta 200 · WalletOperacionesPageResponse

Campos

Campo	Tipo	Descripción
totalPages*	number	—
totalRecords*	number	—
operaciones*	WalletOperacionItemResponse[]	—

{
  "totalPages": 0,
  "totalRecords": 0,
  "operaciones": [
    {
      "id": "string",
      "idExterno": "string",
      "idTrxCoelsa": {},
      "importe": "string",
      "status": "string",
      "cvuDebito": "string",
      "cbuCredito": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "isInternal": true
    }
  ]
}

Errores

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

bank

GET/v1/bank/conciliacion

Transferencias conciliadas por el banco (fecha Debin)

Proxy a la entidad financiera ConciliacionTransferenciasDeBanco. `fecha` = FechaConciliacion (YYYY-MM-DD), por defecto hoy AR. Keys de tenant solo ven CVUs de su PSP.

Parámetros

Nombre	En	Tipo	Notas
fecha*	query	string	—

Respuesta 200

wallet-remuneracion

POST/wallet/v1/Remuneracion/Alta

Alta de cuenta comitente en remuneración de saldos

Request body · EnrollRemuneracionDto · requerido

{}

Respuesta 201

GET/wallet/v1/Remuneracion/Estado/{cvu}

Estado de enrolamiento y saldo valorizado

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200

treasury

GET/v1/treasury

Snapshot de tesorería (sweep)

freeBalance es informativo y puede ser negativo si el PSP usa float de clientes.

Respuesta 200

Treasury snapshot

GET/v1/treasury/positions

Listar posiciones de cliente

Parámetros

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

Respuesta 200

GET/v1/treasury/positions/{cvu}

Saldo de cliente de una CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—

Respuesta 200

GET/v1/treasury/positions/{cvu}/movements

Movimientos del libro cliente

Parámetros

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

Respuesta 200

GET/v1/treasury/positions/{cvu}/balance/historical

Saldo histórico de posición cliente

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
date*	query	string	—

Respuesta 200

wallet-treasury

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
date*	query	string	—

Respuesta 200

fees

GET/v1/fees/preview

Preview de comisión sin postear (tarjeta de confirmación)

Parámetros

Nombre	En	Tipo	Notas
cvu*	query	string	—
importe*	query	string	—
voucherTypeCode*	query	string	—

Respuesta 200

fraud

PUT/v1/accounts/{cvu}/fraud/policies/{code}

Override de política de fraude a nivel CVU

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
code*	path	string	—

Request body · UpsertFraudOverrideDto · requerido

Campos

Campo	Tipo	Descripción
enabled	object	—
severity	enum(low \| medium \| high \| critical)	—
action	enum(allow_case \| reject \| reject_suspend)	—
params	object	—

{
  "enabled": {},
  "severity": "low",
  "action": "allow_case",
  "params": {}
}

Respuesta 200

DELETE/v1/accounts/{cvu}/fraud/policies/{code}

Eliminar override CVU (vuelve a PSP/plataforma)

Parámetros

Nombre	En	Tipo	Notas
cvu*	path	string	—
code*	path	string	—

Respuesta 200

debin

POST/v1/debin/adhesiones

Adherir recurrencia (Programado o Recurrente). Baja: activo=false + id

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateDebinAdhesionDto · requerido

Campos

Campo	Tipo	Descripción
vendedor*	AdherirVendedorDto	—
comprador*	AdherirCompradorDto	—
debin*	AdherirDebinDto	—
id	number	la red de pagos recurrence id. Required for baja (activo=false) and updates.
activo	boolean	false = baja de la recurrencia (requiere id)
tipo_adhesion	number	Alta: 0 no propia / 1 propia. Baja: 0 normal / 1 definitiva.
role	enum(vendedor \| comprador)	—
kind	enum(programado \| recurrente)	Default: programado if limite_cuotas set, else recurrente

{
  "vendedor": {
    "cuit": "30712345678"
  },
  "comprador": {
    "cuit": "20345678901",
    "cbu": "0000003100010000000001"
  },
  "debin": {
    "moneda": "032",
    "concepto": "FAC",
    "detalle": "Cuota servicio",
    "prestacion": "Suscripcion mensual",
    "referencia": "REF-001",
    "limite_cuotas": 12,
    "importe": 1500.5
  },
  "id": 0,
  "activo": true,
  "tipo_adhesion": 0,
  "role": "vendedor",
  "kind": "programado"
}

Respuesta 201 · DebinAdhesionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(vendedor \| comprador)	—
kind*	enum(programado \| recurrente)	—
status*	enum(pending \| pending_confirm \| active \| inactive \| failed)	—
vendedorCuit*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
prestacion*	string	—
referencia*	string	—
limiteCuotas	object	—
importe	object	—
coelsaAdhesionId	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "vendedor",
  "kind": "programado",
  "status": "pending",
  "vendedorCuit": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "prestacion": "string",
  "referencia": "string",
  "limiteCuotas": {},
  "importe": {},
  "coelsaAdhesionId": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

GET/v1/debin/adhesiones

Listar adhesiones Debin

Parámetros

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

Respuesta 200 · PaginatedDebinAdhesiones

Campos

Campo	Tipo	Descripción
total*	number	—
limit*	number	—
offset*	number	—
items*	DebinAdhesionResponse[]	—

{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "items": [
    {
      "id": "string",
      "tenantId": "string",
      "role": "vendedor",
      "kind": "programado",
      "status": "pending",
      "vendedorCuit": "string",
      "compradorCuit": "string",
      "compradorCbu": "string",
      "prestacion": "string",
      "referencia": "string",
      "limiteCuotas": {},
      "importe": {},
      "coelsaAdhesionId": {},
      "respuestaCodigo": {},
      "respuestaDescripcion": {},
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

POST/v1/debin/adhesiones/confirmar

Comprador: ConfirmarRecurrencia (aprobar/rechazar adhesión)

Request body · ConfirmarRecurrenciaDto · requerido

Campos

Campo	Tipo	Descripción
id*	number	la red de pagos recurrence id
autorizacion*	boolean	true = aprobar, false = rechazar
vendedor*	ConfirmVendedorDto	—
comprador*	ConfirmCompradorDto	—
debin*	ConfirmDebinDto	—
adhesionId	string	Local adhesion UUID (optional; looks up by la red de pagos id if omitted)

{
  "id": 0,
  "autorizacion": true,
  "vendedor": {
    "cuit": "string"
  },
  "comprador": {
    "cuit": "string",
    "cbu": "string"
  },
  "debin": {
    "moneda": "032",
    "prestacion": "string",
    "referencia": "string"
  },
  "adhesionId": "string"
}

Respuesta 200 · DebinAdhesionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(vendedor \| comprador)	—
kind*	enum(programado \| recurrente)	—
status*	enum(pending \| pending_confirm \| active \| inactive \| failed)	—
vendedorCuit*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
prestacion*	string	—
referencia*	string	—
limiteCuotas	object	—
importe	object	—
coelsaAdhesionId	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "vendedor",
  "kind": "programado",
  "status": "pending",
  "vendedorCuit": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "prestacion": "string",
  "referencia": "string",
  "limiteCuotas": {},
  "importe": {},
  "coelsaAdhesionId": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/adhesiones/baja

Comprador: baja adhesión (activo=false + tipo_adhesion)

Request body · BajaAdhesionDto · requerido

Campos

Campo	Tipo	Descripción
adhesionId	string	Local adhesion UUID; if omitted use la red de pagosAdhesionId
coelsaAdhesionId	number	la red de pagos recurrence id
tipo_adhesion	number	0 = baja normal (INACTIVA), 1 = baja definitiva

{
  "adhesionId": "string",
  "coelsaAdhesionId": 0,
  "tipo_adhesion": 0
}

Respuesta 200 · DebinAdhesionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(vendedor \| comprador)	—
kind*	enum(programado \| recurrente)	—
status*	enum(pending \| pending_confirm \| active \| inactive \| failed)	—
vendedorCuit*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
prestacion*	string	—
referencia*	string	—
limiteCuotas	object	—
importe	object	—
coelsaAdhesionId	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "vendedor",
  "kind": "programado",
  "status": "pending",
  "vendedorCuit": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "prestacion": "string",
  "referencia": "string",
  "limiteCuotas": {},
  "importe": {},
  "coelsaAdhesionId": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/spot

Crear Debin Spot

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateDebinSpotDto · requerido

Campos

Campo	Tipo	Descripción
ori_trx_id	string	Originator id (max 40). Auto-generated if omitted.
vendedor*	ProgramadoVendedorDto	—
comprador*	ProgramadoCompradorDto	—
detalle*	ProgramadoDetalleDto	—
datosGenerador	ProgramadoDatosGeneradorDto	—

{
  "ori_trx_id": "string",
  "vendedor": {
    "cuit": "string",
    "cbu": "string",
    "banco": "322",
    "sucursal": "string",
    "terminal": "string",
    "prestacion": "string",
    "recurrencia": true
  },
  "comprador": {
    "cuit": "string",
    "cuenta": {
      "cbu": "string",
      "alias": "string"
    }
  },
  "detalle": {
    "concepto": "CUO",
    "idUsuario": 0,
    "idComprobante": 0,
    "moneda": "032",
    "importe": 1500.5,
    "devolucion": true,
    "tiempoExpiracion": 1440,
    "descripcion": "001/012",
    "mismoTitular": 0,
    "idLote": 0
  },
  "datosGenerador": {
    "ipCliente": "string",
    "tipoDispositivo": "string",
    "plataforma": "string"
  }
}

Respuesta 201 · DebinProgramadoResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/pull

Crear Transferencia Pull (requiere X-TRX-PULL o body.trxPullToken)

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—
x-trx-pull	header	string	Consent JWT (alt: body.trxPullToken / DEBIN_TRX_PULL_TOKEN)

Request body · CreateDebinPullDto · requerido

Campos

Campo	Tipo	Descripción
ori_trx_id	string	—
trxPullToken	string	Consent JWT for la red de pagos header X-TRX-PULL
tacito	boolean	Use TransferenciaPullTacito instead of TransferenciaPull
vendedor*	PullVendedorDto	—
comprador*	PullCompradorDto	—
detalle*	PullDetalleDto	—
datosGenerador	PullDatosGeneradorDto	—

{
  "ori_trx_id": "string",
  "trxPullToken": "string",
  "tacito": true,
  "vendedor": {
    "cuit": "string",
    "cbu": "string",
    "banco": "322",
    "sucursal": "string",
    "terminal": "string",
    "recurrencia": true
  },
  "comprador": {
    "cuit": "string",
    "cuenta": {
      "cbu": "string",
      "alias": "string"
    }
  },
  "detalle": {
    "concepto": "VAR",
    "idUsuario": 0,
    "idComprobante": 0,
    "moneda": "032",
    "importe": 1500.5,
    "devolucion": true,
    "tiempoExpiracion": 15,
    "descripcion": "string",
    "mismoTitular": 0,
    "idLote": 0
  },
  "datosGenerador": {
    "ipCliente": "string",
    "tipoDispositivo": "string",
    "plataforma": "string"
  }
}

Respuesta 201 · DebinProgramadoResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/programado

Crear Debin Programado (cuota)

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateDebinProgramadoDto · requerido

Campos

Campo	Tipo	Descripción
ori_trx_id	string	Originator id (max 40). Auto-generated if omitted.
vendedor*	ProgramadoVendedorDto	—
comprador*	ProgramadoCompradorDto	—
detalle*	ProgramadoDetalleDto	—
datosGenerador	ProgramadoDatosGeneradorDto	—
adhesionId	string	Local adhesion UUID to link

{
  "ori_trx_id": "string",
  "vendedor": {
    "cuit": "string",
    "cbu": "string",
    "banco": "322",
    "sucursal": "string",
    "terminal": "string",
    "prestacion": "string",
    "recurrencia": true
  },
  "comprador": {
    "cuit": "string",
    "cuenta": {
      "cbu": "string",
      "alias": "string"
    }
  },
  "detalle": {
    "concepto": "CUO",
    "idUsuario": 0,
    "idComprobante": 0,
    "moneda": "032",
    "importe": 1500.5,
    "devolucion": true,
    "tiempoExpiracion": 1440,
    "descripcion": "001/012",
    "mismoTitular": 0,
    "idLote": 0
  },
  "datosGenerador": {
    "ipCliente": "string",
    "tipoDispositivo": "string",
    "plataforma": "string"
  },
  "adhesionId": "string"
}

Respuesta 201 · DebinProgramadoResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

GET/v1/debin/programado

Listar Debin (Spot + Programado)

Parámetros

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

Respuesta 200 · PaginatedDebinProgramados

Campos

Campo	Tipo	Descripción
total*	number	—
limit*	number	—
offset*	number	—
items*	DebinProgramadoResponse[]	—

{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "items": [
    {
      "id": "string",
      "tenantId": "string",
      "subtipo": "SPOT",
      "oriTrxId": "string",
      "coelsaDebinId": {},
      "status": "pending",
      "vendedorCuit": "string",
      "vendedorCbu": "string",
      "compradorCuit": "string",
      "compradorCbu": "string",
      "concepto": "string",
      "moneda": "string",
      "importe": "string",
      "prestacion": "string",
      "descripcion": {},
      "estadoCodigo": {},
      "estadoDescripcion": {},
      "respuestaCodigo": {},
      "respuestaDescripcion": {},
      "coelsaAdhesionId": {},
      "adhesionId": {},
      "fechaExpiracion": {},
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

GET/v1/debin/programado/{id}

Detalle Debin + timeline

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · DebinProgramadoDetailResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—
events*	DebinEventResponse[]	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z",
  "events": [
    {
      "id": "string",
      "seq": 0,
      "type": "string",
      "source": "string",
      "fromStatus": {},
      "toStatus": {},
      "message": {},
      "at": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

POST/v1/debin/programado/{id}/refresh

Consultar estado en la red de pagos (GET Debin)

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · DebinProgramadoResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/programado/{id}/delete

Eliminar Debin en la red de pagos (DELETE Debin/{id}/{cuit})

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · DebinProgramadoResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
subtipo*	enum(SPOT \| PROGRAMADO \| PULL)	—
oriTrxId*	string	—
coelsaDebinId	object	—
status*	enum(pending \| initiated \| pending_buyer \| credited \| finalized \| failed \| expired \| chargeback \| debit_confirmed \| debit_rejected)	—
vendedorCuit*	string	—
vendedorCbu*	string	—
compradorCuit*	string	—
compradorCbu*	string	—
concepto*	string	—
moneda*	string	—
importe*	string	—
prestacion*	string	—
descripcion	object	—
estadoCodigo	object	—
estadoDescripcion	object	—
respuestaCodigo	object	—
respuestaDescripcion	object	—
coelsaAdhesionId	object	—
adhesionId	object	—
fechaExpiracion	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "subtipo": "SPOT",
  "oriTrxId": "string",
  "coelsaDebinId": {},
  "status": "pending",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "concepto": "string",
  "moneda": "string",
  "importe": "string",
  "prestacion": "string",
  "descripcion": {},
  "estadoCodigo": {},
  "estadoDescripcion": {},
  "respuestaCodigo": {},
  "respuestaDescripcion": {},
  "coelsaAdhesionId": {},
  "adhesionId": {},
  "fechaExpiracion": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/debin/confirma-debito

ConfirmaDebitoCVU (PSP comprador)

Request body · ConfirmaDebitoCvuDto · requerido

Campos

Campo	Tipo	Descripción
debinId*	string	la red de pagos Debin id (22)
codigo*	string	00 accept+debit, 01 accept, 02 reject. Homolog error-débito: 20/30/35/40
compradorCuit*	string	—
compradorCbu*	string	—
moneda*	string	—
importe*	number	ej. 1500.5
ori_trx	string	—

{
  "debinId": "string",
  "codigo": "00",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "moneda": "string",
  "importe": 1500.5,
  "ori_trx": "string"
}

Respuesta 201

Errores

POST/v1/debin/contracargo

Contracargo Programado

Request body · CreateDebinContracargoDto · requerido

Campos

Campo	Tipo	Descripción
debinId*	string	la red de pagos Debin id (22)
compradorCuit*	string	—
vendedorCuit*	string	—
importe*	number	—
motivo	string	—

{
  "debinId": "string",
  "compradorCuit": "string",
  "vendedorCuit": "string",
  "importe": 0,
  "motivo": "string"
}

Respuesta 201

Errores

POST/v1/debin/contracargo-pull

ContraCargoPull (Transferencia Pull)

Request body · CreateDebinContracargoPullDto · requerido

Campos

Campo	Tipo	Descripción
operacionOriginal*	ContracargoPullOperacionDto	—
tacito	boolean	Use ContraCargoPullTacito path (default false)

{
  "operacionOriginal": {
    "id": "string",
    "detalle": {
      "importe": 0,
      "moneda": "032",
      "motivo": "string"
    }
  },
  "tacito": true
}

Respuesta 201

Errores

GET/v1/debin

Listar Debin (alias)

Parámetros

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

Respuesta 200 · PaginatedDebinProgramados

Campos

Campo	Tipo	Descripción
total*	number	—
limit*	number	—
offset*	number	—
items*	DebinProgramadoResponse[]	—

{
  "total": 0,
  "limit": 0,
  "offset": 0,
  "items": [
    {
      "id": "string",
      "tenantId": "string",
      "subtipo": "SPOT",
      "oriTrxId": "string",
      "coelsaDebinId": {},
      "status": "pending",
      "vendedorCuit": "string",
      "vendedorCbu": "string",
      "compradorCuit": "string",
      "compradorCbu": "string",
      "concepto": "string",
      "moneda": "string",
      "importe": "string",
      "prestacion": "string",
      "descripcion": {},
      "estadoCodigo": {},
      "estadoDescripcion": {},
      "respuestaCodigo": {},
      "respuestaDescripcion": {},
      "coelsaAdhesionId": {},
      "adhesionId": {},
      "fechaExpiracion": {},
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

GET/v1/debin/{id}

Detalle Debin (alias)

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200

Errores

POST/v1/qr/pay

Pago QR rol billetera → la red de pagos QRDebin

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateQrPayDto · requerido

Campos

Campo	Tipo	Descripción
qr	string	QR raw (EMV / la red de pagos). Prefer with qrIdTrx when known.
qrIdTrx	string	Identificador operación QR (qr_id_trx)
adquirenteCuit	string	CUIT adquirente para GET QRPayment
compradorCuit*	string	CUIT comprador (billetera)
compradorCbu*	string	CBU/CVU comprador
compradorAlias	string	—
vendedorCuit	string	CUIT vendedor (si no se resuelve vía QRPayment)
vendedorCbu	string	—
vendedorBanco	string	—
vendedorSucursal	string	—
vendedorTerminal	string	—
concepto	string	—
moneda*	string	ej. "032"
importe*	number	ej. 100.5
tiempoExpiracion	number	Minutos (1–4320; la red de pagos homolog acepta máx 10)
descripcion	string	—
promoCode	string	Código de campaña / cupón para cashback QR
idBilletera	number	—
subtipo	string	objeto.subtipo la red de pagos
iniciador	string	objeto.iniciador la red de pagos
datosGenerador	object	datos_generador (ip, dispositivo, etc.)

{
  "qr": "string",
  "qrIdTrx": "string",
  "adquirenteCuit": "string",
  "compradorCuit": "string",
  "compradorCbu": "string",
  "compradorAlias": "string",
  "vendedorCuit": "string",
  "vendedorCbu": "string",
  "vendedorBanco": "string",
  "vendedorSucursal": "string",
  "vendedorTerminal": "string",
  "concepto": "string",
  "moneda": "032",
  "importe": 100.5,
  "tiempoExpiracion": 0,
  "descripcion": "string",
  "promoCode": "VERANO10",
  "idBilletera": 0,
  "subtipo": "string",
  "iniciador": "string",
  "datosGenerador": {}
}

Respuesta 201 · QrOperacionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/qr/commerce

Emitir QR comercio (EMV local, rol aceptador)

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateQrCommerceDto · requerido

Campos

Campo	Tipo	Descripción
cvuVendedor*	string	CVU/CBU vendedor (comercio)
cuitVendedor*	string	—
importe	number	Si se omite → QR estático; si presente → dinámico
moneda*	string	ej. "032"
softDescriptor	string	—
mcc	string	—
codigoPostal	string	Código postal del comercio (8 alfanum, EMV tag 61 / IEP postal_code). Default: QR_POSTAL_CODE_DEFAULT
tiempoExpiracion	number	Minutos hasta expiración

{
  "cvuVendedor": "string",
  "cuitVendedor": "string",
  "importe": 0,
  "moneda": "032",
  "softDescriptor": "string",
  "mcc": "string",
  "codigoPostal": "C1001AAA",
  "tiempoExpiracion": 0
}

Respuesta 201 · QrOperacionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/qr/cashout

Cashout QR → la red de pagos CashOut

Parámetros

Nombre	En	Tipo	Notas
idempotency-key*	header	string	—

Request body · CreateQrCashoutDto · requerido

Campos

Campo	Tipo	Descripción
debitoCuit*	string	CUIT cuenta débito (nuestra CVU)
debitoCbu*	string	CBU/CVU débito
debitoBanco	string	—
debitoSucursal	string	—
debitoTitular	string	—
creditoCuit*	string	CUIT crédito destino
creditoCbu*	string	CBU/CVU crédito
creditoBanco*	string	—
creditoSucursal	string	—
moneda*	string	ej. "032"
importe*	number	ej. 100.5
concepto	string	—
descripcion	string	—
tiempoExpiracion	number	Minutos (1–4320)
iniciador	string	—
subtipo	string	—
datosGenerador	object	—

{
  "debitoCuit": "string",
  "debitoCbu": "string",
  "debitoBanco": "string",
  "debitoSucursal": "string",
  "debitoTitular": "string",
  "creditoCuit": "string",
  "creditoCbu": "string",
  "creditoBanco": "string",
  "creditoSucursal": "string",
  "moneda": "032",
  "importe": 100.5,
  "concepto": "string",
  "descripcion": "string",
  "tiempoExpiracion": 0,
  "iniciador": "string",
  "subtipo": "string",
  "datosGenerador": {}
}

Respuesta 201 · QrOperacionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/qr/cashout/confirma

ConfirmaCashOut manual

Request body · ConfirmaQrCashoutDto · requerido

Campos

Campo	Tipo	Descripción
operacionId	string	Local QR operation id
coelsaId	string	la red de pagos cashout id
codigo	string	Success code (default 0)
descripcion	string	—

{
  "operacionId": "string",
  "coelsaId": "string",
  "codigo": "string",
  "descripcion": "string"
}

Respuesta 200 · QrOperacionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

POST/v1/qr/billetera

Alta billetera la red de pagos (ops / platform)

Request body · CreateQrBilleteraDto · requerido

Campos

Campo	Tipo	Descripción
payload*	object	Payload la red de pagos Alta Billetera (passthrough)

{
  "payload": {}
}

Respuesta 201

Errores

GET/v1/qr

Listar operaciones Pago QR

Parámetros

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

Respuesta 200 · PaginatedQrOperaciones

Campos

Campo	Tipo	Descripción
items*	QrOperacionResponse[]	—
total*	number	—
limit*	number	—
offset*	number	—

{
  "items": [
    {
      "id": "string",
      "tenantId": "string",
      "role": "billetera",
      "kind": {},
      "commerceMode": {},
      "status": "created",
      "debinId": {},
      "qrIdTrx": {},
      "paymentReference": {},
      "rawQr": {},
      "cvuComprador": {},
      "cvuVendedor": {},
      "importe": "string",
      "moneda": "string",
      "coelsaCodigo": {},
      "coelsaDescripcion": {},
      "expiresAt": {},
      "createdAt": "2026-07-30T12:00:00.000Z",
      "updatedAt": "2026-07-30T12:00:00.000Z"
    }
  ],
  "total": 0,
  "limit": 0,
  "offset": 0
}

Errores

GET/v1/qr/{id}

Detalle operación Pago QR

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Respuesta 200 · QrOperacionDetailResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—
events*	QrEventResponse[]	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z",
  "events": [
    {
      "id": "string",
      "seq": 0,
      "type": "string",
      "source": "string",
      "fromStatus": {},
      "toStatus": {},
      "message": {},
      "at": "2026-07-30T12:00:00.000Z"
    }
  ]
}

Errores

POST/v1/qr/{id}/contracargo

QRSolicitudContraCargo

Parámetros

Nombre	En	Tipo	Notas
id*	path	string	—

Request body · CreateQrContracargoDto · requerido

Campos

Campo	Tipo	Descripción
motivo	string	—
importe	number	Defaults to operation importe
moneda	string	—

{
  "motivo": "string",
  "importe": 0,
  "moneda": "string"
}

Respuesta 200 · QrOperacionResponse

Campos

Campo	Tipo	Descripción
id*	string	—
tenantId*	string	—
role*	enum(billetera \| aceptador \| cashout)	—
kind	object	—
commerceMode	object	—
status*	enum(created \| pending_confirm \| approved \| rejected \| finalized \| failed \| chargeback)	—
debinId	object	—
qrIdTrx	object	—
paymentReference	object	—
rawQr	object	—
cvuComprador	object	—
cvuVendedor	object	—
importe*	string	—
moneda*	string	—
coelsaCodigo	object	—
coelsaDescripcion	object	—
expiresAt	object	—
createdAt*	string	—
updatedAt*	string	—

{
  "id": "string",
  "tenantId": "string",
  "role": "billetera",
  "kind": {},
  "commerceMode": {},
  "status": "created",
  "debinId": {},
  "qrIdTrx": {},
  "paymentReference": {},
  "rawQr": {},
  "cvuComprador": {},
  "cvuVendedor": {},
  "importe": "string",
  "moneda": "string",
  "coelsaCodigo": {},
  "coelsaDescripcion": {},
  "expiresAt": {},
  "createdAt": "2026-07-30T12:00:00.000Z",
  "updatedAt": "2026-07-30T12:00:00.000Z"
}

Errores

webhooks

GET/v1/webhook-events

List received bank webhook events

Parámetros

Nombre	En	Tipo	Notas
limit*	query	string	—
offset*	query	string	—
type*	query	string	—
status*	query	string	—
q*	query	string	—
desde*	query	string	—
hasta*	query	string	—
cvu*	query	string	—
importeMin*	query	string	—
importeMax*	query	string	—
sort*	query	string	—
order*	query	string	—

Respuesta 200

GET/v1/webhook-events/summary

KPIs de créditos entrantes (totales + top CUIT originante)

Parámetros

Nombre	En	Tipo	Notas
type*	query	string	—
desde*	query	string	—
hasta*	query	string	—
cvu*	query	string	—
importeMin*	query	string	—
importeMax*	query	string	—

Respuesta 200