API keys y primeros pasos con la API

Dónde se crean las API keys

En el dashboard, entra a Desarrolladores (en el menú lateral):

Toca Crear aplicación. Cada integración (tu web, un bot, una tienda) es una aplicación con sus propias API keys y webhooks.
Al crearla te mostramos su primera API key. Para sumar otra, entra a la aplicación y toca Nueva API key.

La clave se muestra una sola vez: cópiala y guárdala en un lugar seguro. Si la pierdes, revócala y crea una nueva. Puedes tener hasta 20 claves en cada modo.

Claves de producción y de prueba

El modo lo define la clave:

Clave	Modo	Se crea en	Host de la API
`vxp_live_...`	Producción (ventas reales)	`dashboard.vexorpay.com`	`https://api.vexorpay.com`
`vxp_test_...`	Pruebas (sandbox)	`dashboard.sandbox.vexorpay.com`	`https://api.sandbox.vexorpay.com`

Cada host sólo acepta claves de su modo: una clave de prueba contra api.vexorpay.com (o una live contra el host de sandbox) responde 403 livemode_mismatch.

Antes de empezar

Necesitas Polar conectado en el dashboard del mismo modo (si no, crear un link responde 400 account_not_connected). Ver Cómo conectar Polar.
En producción, la cuenta tiene que tener la suscripción a vexorpay activa o en prueba; si no, la API responde 402 subscription_required.

Tu primer request: crear un link de pago

La clave va en el header Authorization:

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": 19,
    "title": "Ebook UX en 30 días"
  }'

amount es el monto en dólares (mínimo USD 4). La respuesta trae el link creado, con su url pública (/p/...) para compartir y el checkoutUrl de Polar.

Para probar sin plata real, usa una clave vxp_test_... contra https://api.sandbox.vexorpay.com/api/v1/payment-links.

Errores comunes

Error	Qué significa
`401 unauthorized`	Falta el header `Authorization`.
`401 invalid_key`	La clave es inválida o fue revocada.
`403 livemode_mismatch`	La clave no corresponde a ese host (prueba vs. producción).
`402 subscription_required`	La suscripción a vexorpay no está en prueba ni al día.
`400 account_not_connected`	No hay Polar conectado.
`429`	Superaste el límite de 100 requests por minuto por clave.

Seguridad

No publiques la clave en repositorios ni en código que corra en el navegador.
Si una clave se ve comprometida, revócala desde Desarrolladores y crea una nueva.

Todos los endpoints (links, checkout, ventas, suscripciones, reembolsos, retiros, webhooks) están en la documentación para desarrolladores. Para recibir avisos de cada venta en tu servidor, ver Notificaciones con webhooks.