VA Payments

Los VA payments generan una instrucción dedicada de cuenta virtual que tu integrador puede mostrar directamente dentro de su propio producto. En vez de redirigir al pagador a un checkout hosteado de Basilic, recibís inmediatamente el CVU y el alias para presentar vos mismo las instrucciones de transferencia.

Qué es un VA payment

Un VA payment es un flujo API-only de cobro por transferencia bancaria.
Basilic crea el registro del pago, reserva la cuenta receptora y devuelve el CVU / alias para mostrarle al pagador.
Tu servidor puede consultar el ciclo de vida con GET /api/v1/va-payments y GET /api/v1/va-payments/{id} o reaccionar a callbacks cuando estén configurados.
Actualmente, los VA payments solo están soportados en Argentina y únicamente para instrucciones de transferencia en ARS.

Flujo de VA payment

Qué podés controlar

Lock mode por tiempo, monto o ambos.
Ventana de expiración mediante ttlSeconds.
Identificación opcional del cliente con clientId, clientTaxId y clientName.
Entrega de callbacks a tu backend mediante callbackUrl.
Referencias externas y metadata para conciliar en tus propios sistemas.

Payload del callback

Cuando llega una transferencia y Basilic la matchea a un VA payment, hace un POST a la callbackUrl que configuraste.

Payload del webhook:

{
  "eventId": "uuid",
  "vaPaymentId": "uuid",
  "eventType": "cash_in_received",
  "status": "completed",
  "payload": {
    "vaPaymentId": "uuid",
    "operationId": "internal-op-id",
    "incomingAmount": 4970.00,
    "total": 5000.00,
    "totalWithoutTaxes": 4970.00,
    "taxes": 30.00,
    "receivedAmount": 4970.00,
    "remainingAmount": 0
  },
  "createdAt": "2026-05-18T12:00:00Z"
}

Tipos de evento:

eventType trae uno de estos siete valores, y ningún otro.

`eventType`	Cuándo lo envía Basilic
`created`	Creaste el VA payment
`cash_in_received`	Llegó una transferencia y Basilic la matcheó
`succeeded`	El VA payment quedó pagado por completo
`underpaid`	La transferencia pagó menos que el monto
`overpaid`	La transferencia pagó más que el monto
`failed`	El VA payment venció sin que lo pagaran
`cancelled`	Cancelaste el VA payment

El objeto payload cambia según el evento. Un evento created o cancelled trae el mismo body que la respuesta del endpoint que lo generó. Los eventos que genera una transferencia traen los campos de montos de abajo.

Qué URL recibe cada evento:

Configurás callbackUrl sola, o successUrl y failureUrl juntas. No podés combinarlas.

Configuración	Entrega
`callbackUrl`	Los siete eventos van a esta URL
`successUrl` + `failureUrl`	`succeeded` va a `successUrl`. `failed` y `cancelled` van a `failureUrl`. `underpaid` y `overpaid` van a `successUrl` cuando el VA payment tiene un cliente, y a `failureUrl` cuando no

created y cash_in_received se entregan solo por callbackUrl. La configuración partida no tiene URL para un evento que no es ni éxito ni fallo, así que los descarta. Usá callbackUrl si los necesitás.

Campos del payload:

Campo	Descripción
`payload.incomingAmount`	Monto neto recibido después de impuestos (campo pre-existente, igual a `totalWithoutTaxes`)
`payload.total`	Monto bruto antes de impuestos
`payload.totalWithoutTaxes`	Monto neto después de impuestos (igual a `incomingAmount`)
`payload.taxes`	Impuestos retenidos por el proveedor. `total - taxes = incomingAmount`
`payload.receivedAmount`	Monto acreditado al VA payment (puede diferir si el pago fue parcial o excedió el monto esperado)
`payload.remainingAmount`	Monto pendiente de recibir. `0` cuando está completamente pagado

En la mayoría de las transferencias no hay retenciones y total === incomingAmount con taxes === 0. Para transferencias argentinas con retenciones impositivas, estos campos contienen el desglose.