Paginación

Precaución

GET /orders/ no expone paginación numérica en la ruta pública. El endpoint devuelve un array plano de Payment con todos los resultados del rango consultado.

Controle el tamaño de la respuesta acotando el rango con start y end.

Parámetros

GET /orders/ acepta:

Param	Formato	Default	Descripción
start	YYYY/MM/DD	hoy − 7 días	Fecha inicial (inclusiva, UTC).
end	YYYY/MM/DD	hoy	Fecha final (inclusiva, UTC).

Los parámetros page y items_per_page existen en el código pero actualmente no afectan la respuesta pública (son internos del dashboard). No confíe en ellos; controle volumen por rango.

Ejemplo

curl -H "X-Device-Id: $B4BIT_API_KEY" \
  "https://pos.b4bit.com/api/v1/orders/?start=2026/01/01&end=2026/01/31"

Zona horaria

Las fechas se interpretan en UTC (confirmado en backend, settings.py TIME_ZONE = 'UTC'). Si su comercio opera en otra zona, convierta antes de enviar para evitar que los pagos de la frontera del día queden fuera del rango.

Ordenamiento

Los pagos vienen ordenados por created_at descendente (los más recientes primero).

Recomendaciones

• Batchee por rangos cortos (diarios o semanales) si tiene mucho volumen. Evita respuestas enormes.
• Prefiera webhooks para actualización en tiempo real; use GET /orders/ solo para reconciliación histórica.
• Cuando reconcilie, guarde el último edited_at procesado y filtre por rango a partir de ahí.

Reconciliación recomendada

1. Persista cada webhook entrante marcando identifier + status + edited_at.
2. Una vez al día, llame a GET /orders/?start=ayer&end=hoy y cruce por identifier contra su base.
3. Para los pagos que no coincidan, consulte el detalle con GET /orders/info/{identifier}.