VeloxKey Developers

Reseller API v1.1

Integra catálogo, precios VIP, stock, saldo, pedidos idempotentes y webhooks en tu tienda. Las claves antiguas siguen siendo compatibles.

Base URL

https://veloxkey.com/api/reseller/v1

Idempotencia

Envía Idempotency-Key al crear pedidos para que un reintento nunca duplique la compra.

Referencias externas

Usa external_order_id para relacionar pedidos de tu tienda con VeloxKey.

Webhooks firmados

Recibe order.completed y order.failed con firma HMAC y delivery ID.

Endpoints

GET/products

Catálogo con búsqueda, categoría, stock, paginación y precio VIP.

GET/products/{id}

Detalle, precio y disponibilidad de un producto.

GET/balance

Saldo API, tier VIP y límites actuales.

POST/orders

Compra con Idempotency-Key y referencia externa.

GET/orders

Historial con filtros, fechas y paginación.

GET/orders/{id}

Estado, claves, importes y referencia del pedido.

GET/webhooks

Lista los webhooks configurados.

POST/webhooks

Crea un webhook firmado con HMAC SHA-256.

GET/openapi

Especificación OpenAPI 3.1.

Crear pedido de forma segura

curl -X POST https://veloxkey.com/api/reseller/v1/orders \
  -H "Content-Type: application/json" \
  -H "x-api-key: TU_API_KEY" \
  -H "Idempotency-Key: pedido-mi-tienda-1842" \
  -d '{
    "productId": "UUID_DEL_PRODUCTO",
    "quantity": 1,
    "external_order_id": "ORDER-1842"
  }'

Si tu servidor pierde la respuesta y repite exactamente la petición con la misma Idempotency-Key, VeloxKey devuelve el resultado anterior en vez de volver a cobrar.

Catálogo y filtros

https://veloxkey.com/api/reseller/v1/products?page=1&limit=50&q=spotify&category=Streaming&in_stock=true

Cada producto incluye SKU estable, precio API/VIP, precio base, cashback, stock local, stock de proveedor, disponibilidad y origen del fulfillment.

Rate limits y errores

Todas las respuestas incorporan X-Request-Id. Los límites incluyen X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset y, en HTTP 429, Retry-After.

{
  "success": false,
  "error": {
    "code": "out_of_stock",
    "message": "Product is currently out of fulfillment stock."
  },
  "request_id": "..."
}

Webhooks

Crea un webhook con POST /webhooks. El secreto se muestra una única vez. Verifica X-VeloxKey-Signature calculando HMAC-SHA256 sobre timestamp.body.

Eventos previstos: order.completed, order.failed, product.restocked, product.out_of_stock, product.price_changed y balance.low.

OpenAPI

La especificación se publica en https://veloxkey.com/api/reseller/v1/openapi y puede importarse en Postman, Insomnia o generadores de SDK.