API pública de Deemby.

Consultar elegibilidad, canjear y revertir, acreditar, registrar hyperacciones y recibir webhooks firmados. Ninguna llave ni URL de ambiente vive en esta página.

OAuth2 client credentials + credenciales de corta vidaIdempotency-Key obligatoriaWebhooks firmados

Sandbox con @vatares sintéticos · en camino

Método · ruta	Quién	Para qué
POST /v1/access-check	Marca (caja o app)	Elegibilidad: nivel y respaldados disponibles a partir de una presentación de 60 s; reserva con vigencia
POST /v1/redemptions	Marca	Canje de respaldados con Idempotency-Key; emite los Deembys ganados por compra identificada
POST /v1/redemptions/{id}/reverse	Marca	Reverso de un canje
POST /v1/accruals	Marca	Acredita respaldados por compra; descuenta del fondo prepagado
POST /v1/hyperactions	Integración autorizada	Entrada al motor de Check In: tipo, evidencia E1–E4, celda H3
GET · PUT /v1/rules	Marca	Ficha de reglas: tipos aceptados (≤ 4), escalera, topes, vigencia; versionada
POST /v1/webhook-endpoints	Marca	Alta de destinos; eventos firmados: redemption.completed · accrual.completed · hyperaction.verified · rules.updated
POST /v1/presentments/resolve	Marca	Resuelve una presentación (QR o pase) en una referencia de corta vida

Ilustrativo · POST /v1/access-check

{
  "presentment_ref": "prs_•••• (vence en 60 s)",
  "action": "redemption",
  "amount_estimate": { "value": 180.00, "currency": "MXN" }
}
→ 200
{
  "eligible": true,
  "integration_subject": "sub_•••• (propio de tu integración)",
  "level": "Pink",
  "backed_available": [{ "type": "Pink", "qty": 40 }],
  "reservation_id": "rsv_••••",
  "expires_in": 60
}

Valores y nombres de campos ilustrativos · sin llaves ni secretos.

Lo que nunca devuelve la API

Nombre, documento, teléfono
Ubicación exacta
Tu @vatar público: cada integración recibe un identificador propio

Lo que nunca recibe

Datos de tarjeta: la marca cobra con su propio método

URL base del ambiente y acceso al sandbox: se entregan con el alta. Contacto →