Skip to main content

Confirmación de Retiros

Cuando una orden de retiro llega al estado Pago Instruido, significa que el AM ya instruyó el pago de los fondos a la Wallet. La Wallet debe confirmar que recibió los fondos para que la orden pase a su estado final Completa.

Flujo de confirmación​

Cubierta (fitted) → Pago Instruido → [Wallet confirma recepción] → Completa
  1. El AM ejecuta el retiro y lo marca como Cubierta.
  2. El AM transfiere los fondos a la Wallet y marca la orden como Pago Instruido.
  3. La Wallet recibe los fondos y distribuye al usuario final.
  4. La Wallet confirma la recepción usando el endpoint de registro de pago.

Endpoint de confirmación​

Método: POST
URL: /v1/orders/register_payment/

{
  "order_ids": ["order_FsnhH3d1Iq4LsyTg", "order_abc123def456"]
}

Este endpoint acepta un listado de order_id para confirmar múltiples retiros en una sola llamada.

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.

Consulta de órdenes pendientes de confirmación​

Para identificar las órdenes de retiro que están esperando confirmación de recepción:

Método: GET
URL: /api/v1/orders?status=payment_instructed&side=sell

La Wallet puede implementar un proceso automático que:

  1. Consulte periódicamente las órdenes en estado Pago Instruido.
  2. Verifique contra sus registros bancarios que los fondos fueron acreditados.
  3. Confirme la recepción masivamente usando el endpoint anterior.
Recomendación

Implementar este proceso de forma automática en un job diario al final de la jornada, para no dejar órdenes sin confirmar.