Nóminas

La nómina es el mecanismo de liquidación financiera entre el merchant y la ALyC. La ALyC adelanta el capital para ejecutar todas las órdenes; al final de cada corte operativo, el merchant debe transferir el total de ARS correspondiente.

Aclaración

La nómina no bloquea la operatoria. Las operaciones se ejecutan incluso si el merchant tiene nóminas pendientes de pago.

Generación de nóminas

Las nóminas se generan automáticamente según la configuración del tenant:

• Por horario: en los cortes configurados (ej. 13:00 y 16:00 hs)
• Por límite USD: cuando el acumulado del merchant supera el umbral configurado
• Manual: desde el backoffice de InvWallet a demanda

Estados de la nómina

IN_PROGRESS → PENDING → NOTIFIED → CONFIRMED

Estado	Descripción
IN_PROGRESS	Nómina abierta, acumulando operaciones del período actual
PENDING	Corte realizado — el merchant debe transferir el total_amount_ars
NOTIFIED	InvWallet notificó al merchant
CONFIRMED	El merchant informó la referencia de transferencia via API

Consulta de nóminas

Método: GET
URL: /api/v1/mep/paysheets/

Retorna todas las nóminas del merchant, ordenadas por fecha de corte descendente.

[
  {
    "id": 15,
    "merchant": 3,
    "merchant_name": "Billetera XYZ",
    "cut_datetime": "2026-04-28T13:00:00Z",
    "total_amount_ars": "250000.00",
    "total_amount_usd": "223.80",
    "side": 1,
    "operations_count": 5,
    "status": 1,
    "status_display": "Pendiente",
    "transfer_reference": null,
    "created": "2026-04-28T13:00:05Z",
    "updated": "2026-04-28T13:00:05Z"
  }
]

Campo	Descripción
cut_datetime	Momento del corte operativo que generó la nómina
total_amount_ars	Total ARS que el merchant debe transferir a la ALyC
total_amount_usd	Total USD equivalente de las operaciones
operations_count	Cantidad de operaciones incluidas
status / status_display	Estado de la nómina
transfer_reference	Referencia bancaria informada por el merchant (null hasta confirmar)

Para consultar solo las nóminas pendientes de pago:

Método: GET
URL: /api/v1/mep/paysheets/pending/

Se recomienda monitorear este endpoint periódicamente (ej. cada 30 minutos durante el horario de mercado).

Confirmar transferencia

Cuando el merchant realiza la transferencia bancaria, debe informarla a InvWallet con la referencia.

Método: POST
URL: /api/v1/mep/paysheets/{id}/confirm_transfer/

{
  "transfer_reference": "CBU-REF-20260428-001"
}

Respuesta 200: nómina con status actualizado y transfer_reference registrado.

Responsabilidad del merchant ante una nómina PENDING

1. Consultar el detalle: GET /api/v1/mep/paysheets/{id}/
2. Transferir total_amount_ars al CBU ARS de la ALyC (dato provisto por Invera durante el onboarding)
3. Confirmar la transferencia: POST /api/v1/mep/paysheets/{id}/confirm_transfer/ con la referencia bancaria

Importante

El CBU destino de la ALyC es provisto por Invera durante el proceso de onboarding del merchant. No está expuesto en la API.