Saltar al contenido principal

Listar renovaciones

GET 
/v1/invoices

Lista las renovaciones de la cuenta. Las renovaciones representan cada período de cobro de un cargo recurrente. ONVO crea una renovación al inicio de la suscripción y en cada renovación exitosa. Cada renovación está asociada a una intención de pago y permite consultar el cobro que corresponde a ese período.

Ejemplos de URLs:

  • Paginación: GET /v1/invoices?limit=25&startingAfter=cl40muorw00493ndp0okzk2g3
  • Filtrar por cliente y estado: GET /v1/invoices?customerId=cl40muorw00493ndp0okzk2g3&status=paid
  • Filtrar por varios estados: GET /v1/invoices?status=open,paid
  • Filtrar por rango de fechas: GET /v1/invoices?createdAt[gte]=2026-01-01T00:00:00.000Z&createdAt[lte]=2026-01-31T23:59:59.999Z
  • Filtrar por rango de montos: GET /v1/invoices?total[gte]=1000&total[lte]=5000
  • Filtrar por metadata: GET /v1/invoices?metadata[key]=orderId&metadata[value]=order_123
  • Expandir objetos relacionados: GET /v1/invoices?expand=payment_intent&expand=subscription

Si construís la URL manualmente, podés escribir filtros con corchetes como createdAt[gte] y metadata[key]. Los clientes HTTP suelen codificarlos como createdAt%5Bgte%5D y metadata%5Bkey%5D al enviar la solicitud.

Solicitud​

Respuestas​

OK