Primeros pasos

1. Activa tu cuenta de cobro

Para poder cobrar necesitas activar tu cuenta de cobro desde el dashboard de vexorpay (Cuenta de cobro): cargas el nombre de tu negocio, que ve el comprador en el checkout, y verificas tu identidad. Los links se pueden crear con la verificación pendiente; para retirar el dinero hace falta completarla. Sin la cuenta de cobro, la API devuelve 409 payment_account_not_ready.

Sin suscripción: cada venta paga una sola comisión de vexorpay, desde 2,7 % + USD 1 con el procesamiento incluido (ver Cómo funcionan los cobros).

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.