Ventas de Polar

Si cobrás con Polar, cada venta (un pago único o la renovación de una suscripción) es una order. Polar es el Merchant of Record: cobra al comprador, calcula y liquida el impuesto y te acredita el neto en tu saldo de Polar (ver Saldo). Las ventas que cobraste antes con Stripe siguen en Cobros.

El objeto Order

{
  "id": "66f1c1e2c8a4b0d1f2e3a4d1",
  "provider": "polar",
  "polarOrderId": "5ca7caa3-d059-49aa-85c0-a0dfbee9844e",
  "paymentLinkId": "66f1c1e2c8a4b0d1f2e3a4b5",
  "polarSubscriptionId": null,
  "status": "paid",
  "billingReason": "purchase",
  "currency": "usd",
  "subtotalCents": 2500,
  "taxCents": 0,
  "totalCents": 2500,
  "netCents": 2337,
  "refundedCents": 0,
  "refundableCents": 2500,
  "customerEmail": "cliente@ejemplo.com",
  "customerName": "Ana Pérez",
  "productName": "Curso de fotografía",
  "seats": null,
  "sandbox": false,
  "createdAt": "2026-10-24T07:55:33.971Z"
}

• totalCents es lo que pagó el comprador y taxCents, el impuesto que liquida Polar. netCents es el monto sin impuesto (después de descuentos): es lo que Polar acredita en tu saldo, y de ahí descuenta su comisión. Lo que te queda por cada venta lo ves en Movimientos del dashboard.
• subtotalCents es el precio antes de descuentos; si el precio tenía el impuesto incluido (compradores de la UE), el impuesto está adentro.
• refundableCents es lo que todavía se puede reembolsar (sin impuesto).
• status: paid, partially_refunded, refunded, pending o void.
• billingReason: purchase (pago único), subscription_create o subscription_cycle (renovación).

Listar ventas

GET /api/v1/orders

curl "https://api.vexorpay.com/api/v1/orders?status=paid" \
  -H "Authorization: Bearer vxp_live_tu_clave"

Ver una venta

GET /api/v1/orders/{id}

Devuelve la venta o 404 order_not_found.

Reembolsar una venta

POST /api/v1/orders/{id}/refund

Reembolsa una venta paid o partially_refunded, total o parcialmente. El dinero sale de tu saldo de Polar y el impuesto se devuelve en proporción. Es irreversible. Soporta Idempotency-Key: un replay devuelve la venta sin volver a reembolsar.

curl -X POST https://api.vexorpay.com/api/v1/orders/66f1c1e2c8a4b0d1f2e3a4d1/refund \
  -H "Authorization: Bearer vxp_live_tu_clave" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: refund-ORD-1001" \
  -d '{ "amount": 10, "reason": "customer_request" }'

Devuelve la venta actualizada (refundedCents, refundableCents y status).

Errores