Confirmación de Retiros

Cuando una nómina de retiros llega al estado Pago Instruido, significa que el ACDI/AM ya instruyó el pago de los fondos a la Wallet. La Wallet debe confirmar que recibió los fondos para que las órdenes pasen a su estado final Completa.

Flujo de confirmación

Cubierta (fitted) → Pago Instruido → [Wallet confirma recepción] → Completa

1. La SG ejecuta los retiros y los marca como Cubierta.
2. El ACDI/AM transfiere los fondos a la Wallet y marca la nómina como Pago Instruido.
3. La Wallet recibe los fondos y los distribuye a los usuarios finales.
4. La Wallet confirma la recepción usando el endpoint de registro de pago a nivel nómina.

Consulta de la nómina

Para obtener el paysheet_by_fund_class_id de las nóminas de retiro pendientes de confirmación:

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

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

Endpoint de confirmación

Método: POST URL: /api/v1/paysheets/{paysheet_by_fund_class_id}/register_payment/

Código	Descripción
202 Accepted	La recepción fue registrada correctamente
400 Bad Request	La nómina no está en un estado válido para confirmar

Importante

Si la Wallet no confirma la recepción, las órdenes quedan indefinidamente en estado Pago Instruido y no se completan. Esto puede generar inconsistencias en los reportes de conciliación.

Recomendación

Implementar este proceso como un job diario al final de la jornada para no dejar nóminas sin confirmar.