Clientes

Cada persona que te compra por uno de tus links es un customer. La API te devuelve tus clientes con sus totales y, en el detalle, sus ventas y sus suscripciones. Los clientes se arman a partir de tus ventas: un cliente es una persona (un email) que compró al menos una vez.

El objeto Customer

{
  "id": "cliente@ejemplo.com",
  "email": "cliente@ejemplo.com",
  "name": "Ana Pérez",
  "ordersCount": 3,
  "totalSpentCents": 6400,
  "activeSubscriptions": 1,
  "firstPurchaseAt": "2026-10-24T01:47:49.220Z",
  "lastPurchaseAt": "2026-10-26T18:41:11.098Z"
}

• id identifica al cliente (el email normalizado o un id interno). Trátalo como un valor opaco y úsalo tal cual, codificado en la URL, en GET /api/v1/customers/{id}.
• totalSpentCents es lo que pagó el cliente, en centavos de USD, neto de reembolsos.
• ordersCount cuenta las ventas pagadas, incluidas las reembolsadas.
• activeSubscriptions cuenta las suscripciones active, trialing o past_due.
• firstPurchaseAt / lastPurchaseAt: la primera y la última compra.

Listar clientes

GET /api/v1/customers

De la compra más reciente a la más vieja.

curl "https://api.vexorpay.com/api/v1/customers?query=ana" \
  -H "Authorization: Bearer vxp_live_tu_clave"

Ver un cliente

GET /api/v1/customers/{id}

Devuelve el cliente con dos campos más: orders (sus ventas, hasta 100, más nuevas primero, con el formato de Ventas) y subscriptions (sus suscripciones, con el formato de Suscripciones). Para reembolsar una de sus ventas usa POST /api/v1/orders/{id}/refund.

curl "https://api.vexorpay.com/api/v1/customers/cliente%40ejemplo.com" \
  -H "Authorization: Bearer vxp_live_tu_clave"

Errores