Conciliar

Concilia con GET /v1/movements como fuente de lo que pasó en tu cuenta, y con GET /v1/events para saber qué cambió desde tu última lectura. Cada consulta de eventos empieza sin cursor, en el más nuevo: ver El evento siempre queda guardado.

MétodoCopiar enlace

1. Consulta movimientos con un cursor durable. Ver Movimientos y recibos.
2. Empata cada movimiento con tu registro. payment_id es el pay_ del pago de origen y external_ref es tu referencia. payment_id viene en null en depósitos, en lo que no salió de esta API y en un cobro, que sí trae external_ref.
3. Revisa read_status: partial significa que el dato aún no está completo y debes releerlo.
4. Trata returned después de completed como una reversa, y cualquier otro retroceso publicado como una corrección.
5. Guarda el recibo de los movimientos terminales.

EventosCopiar enlace

Pide la lista sin cursor y recorre con next_cursor hacia el pasado hasta llegar a un evento que ya procesaste. No guardes next_cursor entre consultas: sólo camina hacia el pasado.

export FITAL_API="https://widget.fital.xyz/explorar/v1"
export FITAL_KEY="sk_test_sandbox_publica"

# Empieza sin cursor, en el evento más nuevo. CURSOR sólo sirve para seguir esta vuelta hacia atrás: no lo guardes entre consultas.
CURSOR=""
curl -sS -G "$FITAL_API/events" \
  -H "Authorization: Bearer $FITAL_KEY" \
  --data-urlencode "limit=25" \
  ${CURSOR:+--data-urlencode "cursor=$CURSOR"}

Devoluciones tardíasCopiar enlace

Una devolución puede no llegar sola: fuera de latam depende del aviso del riel, en cualquier plazo, y en latam la vigilancia dura 120 días. Si tu cierre depende de un pago, consulta GET /v1/payments/{id}, que lee en vivo. Ver Vigilancia de un pago completado.

Errores comunesCopiar enlace

• Cerrar el día con movimientos en processing.
• Usar para eventos un cursor durable, como el de movimientos. En GET /v1/events no verías lo nuevo.
• Ignorar returned: un pago completed puede revertirse después.
• Conciliar con GET /v1/payments: es una vista y puede ir atrasada. Usa movimientos y el detalle del pago.

Qué sigueCopiar enlace

Reintentos.

Ver esta página en Markdown