Para desarrolladores

API REST v1

Crea sesiones de juego, consulta premios, registra canjes y recibe eventos en tu sistema. Las llaves se generan en Panel › Integraciones.

openapi.json Obtener llaves

Autenticación

Envía tu llave secreta como Bearer token. Nunca la expongas en el navegador.

Authorization: Bearer pxp_sk_…

Idempotencia

En operaciones POST envía Idempotency-Key con un valor único por operación. Reintentar con la misma llave devuelve la misma respuesta sin duplicar efectos.

Webhooks firmados

Cada envío incluye una firma HMAC SHA-256 del timestamp y el cuerpo. Verifícala con el secreto del endpoint y rechaza timestamps antiguos.

X-Pixaplay-Signature: t=1730000000,v1=…
v1 = hmac_sha256(secret, t + "." + body)

Límites de tasa

Las llaves de comercio tienen un límite por minuto. Si lo superas recibirás 429; respeta la cabecera Retry-After y reintenta con espera exponencial.

Errores

Todas las respuestas de error usan el mismo formato, con un código estable para tu lógica y un mensaje legible.

{ "error": { "code": "invalid", "message": "Ingresa un correo válido para participar." } }

Referencia

Cargando la referencia…