Primeros pasos

1. Conecta Polar

Las ventas las cobra Polar, el Merchant of Record de vexorpay. Para poder cobrar necesitas conectar tu cuenta de Polar desde el dashboard de vexorpay (Conectar con Polar). Sin Polar conectado, la API devuelve account_not_connected; si tu organización de Polar todavía no puede cobrar, polar_not_ready.

2. Crea tu API key

Desde Configuración → API keys del dashboard, crea una clave nueva. Se muestra una sola vez, así que copiala y guardala en un lugar seguro.

La clave de producción tiene el formato vxp_live_... (la de pruebas, vxp_test_...) y se envía en el header Authorization de cada request. El modo lo define la clave, no el request.

3. Haz tu primer request

curl https://api.vexorpay.com/api/v1/payment-links \
  -X POST \
  -H "Authorization: Bearer vxp_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 25,
    "title": "Mi primer cobro",
    "description": "Consultoría de diseño",
    "reference": "SEMANA-1"
  }'

El monto mínimo por cobro es USD 4. El campo reference te sirve para identificar el cobro con tu n° de orden y para reconciliar pagos.

4. Comparte el link

La respuesta incluye url (la página pública de pago) y el link queda activo para cobrar.

5. Saber cuándo te pagan

Configura un webhook para que tu servidor reciba payment.completed cuando un cliente paga, o consulta GET /api/v1/orders?status=paid / GET /api/v1/events a demanda.

Próximo paso

Sigue con la guía de venta de producto digital para ver el flujo completo de punta a punta.