Consulta y listado

Usa GET /v1/payments/{paymentId} para obtener el estado autoritativo. Para operaciones de soporte, usa GET /v1/payments con los filtros publicados y procesa cada página hasta agotar el cursor; guarda el cursor como dato efímero y no asumas que la primera página contiene todo.

import { createTimbroPayments } from "@timbro/payments";

const secretKey = process.env.TIMBRO_PAYMENTS_SECRET_KEY;
if (!secretKey) throw new Error("Missing TIMBRO_PAYMENTS_SECRET_KEY");
const timbro = createTimbroPayments({ secretKey });
const payment = await timbro.payments.retrieve("payment_123");

Después de un timeout o una respuesta perdida, consulta la misma referencia y el mismo entorno. No crees otro pago para “probar” qué ocurrió.

Los webhooks sólo aceleran la notificación. Deduplica por identificador de evento, tolera entregas fuera de orden y vuelve a consultar el recurso antes de cerrar una orden.