Nóminas y Transferencia

Una vez que las órdenes son creadas por la Wallet, InvWallet las agrupa en nóminas según el fondo y tipo de operación. La Wallet debe consultar estas nóminas para conocer el monto a transferir.

Consulta de nóminas

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

La respuesta incluye las nóminas generadas con el detalle de cada una:

{
    "count": 1,
    "results": [
        {
            "paysheet_by_fund_class_id": "pyfc_JjOKVsZrJpVVYyhHk",
            "fund_class_name": "B",
            "amount": "123450.60",
            "side": "buy",
            "status_detail": "Pendiente",
            "paid": false
        }
    ]
}

Error común — Pago por orden individual

El pago de suscripciones siempre se realiza por nómina, no por orden individual. La Wallet debe consultar la nómina y realizar un único pago por el total indicado en amount.

Circuito de pago

1. La Wallet consulta las nóminas para conocer el monto total a transferir.
2. La Wallet transfiere los fondos al AM. La transferencia puede ser en globo (recomendado) o individual. El modo se define entre el AM y la Wallet.
3. El AM marca la nómina como pagada (paid: true).
4. El AM envía la nómina para ejecución.

Importante

La nómina no se envía para ejecución hasta que el AM confirme la recepción de los fondos.

Estados de las nóminas

Estado	Descripción
Pendiente	Nómina generada, esperando pago de la Wallet
Enviada	Nómina enviada al Asset Manager
Completa	Estado final para suscripciones. El AM procesó y confirmó la operación
Pago Instruido	Estado para retiros. El AM instruyó el pago al cliente. Cuando la Wallet confirma la recepción, pasa a Completa
Fallida	La nómina no pudo ser procesada

Simulación en Sandbox

En sandbox, los procesos de nóminas que en producción son automáticos deben ejecutarse manualmente:

1. Generar nóminas — POST /v1/paysheets/sandbox_generate_paysheets/
2. Validar nóminas — POST /v1/paysheets/sandbox_validate_paysheets/
3. Simular pago de suscripción — POST /v1/orders/{id}/simulate_payment/
4. Procesar nóminas — POST /v1/paysheets/sandbox_process_paysheets/

info

En producción, los pasos 1, 2 y 4 son automáticos según los horarios configurados. El paso 3 se reemplaza por la transferencia bancaria real.