Cobros
Consulta los cobros de tu cuenta, un cobro puntual y el comprobante en PDF.
Los cobros (charge) representan cada pago. Consultá el histórico con filtros o descargá el comprobante de un pago completado.
Listar cobros
GET /api/v1/charges
Parámetros
| Parámetro | Descripción |
|---|---|
payment_link_id | Filtrar por link de pago. |
status | pending, paid, failed, refunded o disputed. |
reference | Filtrar por la referencia del cobro (p. ej. ORD-1001). |
sandbox | true (solo cobros de prueba) o false (solo producción). Sin el parámetro devuelve ambos entornos. |
limit / starting_after / ending_before | Paginación por cursor (default 10, máximo 100). |
Ejemplo
curl "https://api.vexorpay.com/api/v1/charges?status=paid&reference=ORD-1001" \
-H "Authorization: Bearer vxp_u_tu_clave"Respuesta exitosa
200 OK
{
"data": [
{
"id": "67f1c1e2c8a4b0d1f2e3a4b5",
"paymentLinkId": "66f1c1e2c8a4b0d1f2e3a4b5",
"reference": "ORD-1001",
"amountCents": 1900,
"currency": "usd",
"status": "paid",
"sandbox": false,
"platformFeeCents": 100,
"stripeFeeCents": 90,
"netCents": 1710,
"customerEmail": "cliente@mail.com",
"metadata": { "userId": "u_42" },
"paidAt": "2026-01-02T12:05:00.000Z",
"createdAt": "2026-01-02T12:03:00.000Z",
"refundedCents": null,
"recoveredCents": null,
"disputeStatus": null,
"disputeOutcome": null
}
],
"has_more": false,
"total_count": 1,
"url": "/v1/charges?limit=10"
}Campos de reembolsos y disputas:
refundedCents: total reembolsado al comprador.recoveredCents: total reversado/recuperado de tu cuenta.disputeStatus:needs_response,under_review,warning_needs_response,closedonull.disputeOutcome:won,lostonull.
Obtener un cobro
GET /api/v1/charges/{id}
En sandbox, mandá ?sandbox=true. La respuesta incluye el cobro completo más tres embeds: paymentLink (resumen), fees (desglose de comisiones) y receiptUrl.
{
"id": "67f1c1e2c8a4b0d1f2e3a4b5",
"reference": "ORD-1001",
"amountCents": 1900,
"currency": "usd",
"status": "paid",
"netCents": 1710,
"paidAt": "2026-01-02T12:05:00.000Z",
"paymentLink": {
"id": "66f1c1e2c8a4b0d1f2e3a4b5",
"title": "Ebook UX en 30 días",
"slug": "a1b2c3d4e5",
"url": "https://www.vexorpay.com/p/a1b2c3d4e5"
},
"fees": {
"vexor": { "amountCents": 100, "currency": "usd" },
"stripe": { "amountCents": 90, "currency": "usd" },
"net": { "amountCents": 1710, "currency": "usd" }
},
"receiptUrl": "/v1/charges/67f1c1e2c8a4b0d1f2e3a4b5/receipt"
}curl https://api.vexorpay.com/api/v1/charges/67f1c1e2c8a4b0d1f2e3a4b5 \
-H "Authorization: Bearer vxp_u_tu_clave"Devuelve el cobro completo o 404 charge_not_found.
Comprobante
GET /api/v1/charges/{id}/receipt
curl -O -J https://api.vexorpay.com/api/v1/charges/67f1c1e2c8a4b0d1f2e3a4b5/receipt \
-H "Authorization: Bearer vxp_u_tu_clave"
# → recibo en PDFDisponible solo para cobros paid (si está pendiente devuelve 400 invalid_request). En sandbox, mandá ?sandbox=true.
Errores
| Error | HTTP | Causa |
|---|---|---|
validation_error | 400 | status no es un estado válido. |
charge_not_found | 404 | No existe ese cobro en tu cuenta. |
invalid_request | 400 | El comprobante solo está disponible para pagos completados. |