Especificación OpenAPI

La API pública de vexorpay publica su especificación OpenAPI 3.0.3, la estándar de la industria para describir una API REST. Sirve para explorar los endpoints, generar clientes/SDKs, y validar contratos en tus propios tests.

• Especificación (JSON): developers.vexorpay.com/openapi.json — también disponible en el host de la API (https://api.vexorpay.com/openapi.json en producción).
• La spec se genera desde el mismo código que responde los endpoints, así que siempre refleja el comportamiento real (parámetros, bodies, códigos de error, rate limit e idempotencia).

Cómo usarla

La spec es un documento estándar: la consume cualquier tooling de OpenAPI (para generar un cliente, validar el contrato en tus tests o levantar un mock server). No tiene UI interactiva propia; para probar un endpoint sin escribir código la puedes abrir en un visor de OpenAPI, o usar la colección de Postman que ya trae todos los requests configurados con tu API key.

Las requests de la API se autentican con tu API key (vxp_live_... para producción, vxp_test_... para sandbox), creada en el dashboard → Desarrolladores → API keys, y van contra el host de API del entorno donde estés parado (api.vexorpay.com en producción, api.sandbox.vexorpay.com en sandbox). El rate limit de 100 req/min por API key aplica igual que en cualquier integración.

Notas

• Los montos de la API van en dólares (amount: 10.5 = USD 10.50); los campos *Cents de las respuestas van en centavos.
• El modo lo define la API key, no el request: vxp_live_... opera sobre producción y vxp_test_... sobre sandbox. Cada host solo acepta claves de su modo (una clave en el host equivocado responde 403 livemode_mismatch).
• Los POST de creación aceptan el header Idempotency-Key: misma clave + mismo body devuelve el recurso ya creado.
• Si prefieres un cliente ya armado, hay una colección de Postman.