Reservar webhooks (inventario bajo demanda)

Configura un punto final HTTPS por oferta que devuelva valores de campo para listados COMPLEJOS. El pago aún se completa si la llamada falla; puedes reintentar o cumplir manualmente.

Obtén licencia, cuenta o valores de clave de tu servidor cuando un comprador paga.

Cuándo usar webhooks de reserva

Usa esto para inventario COMPLEJO (unidad única) cuando generes claves o cuentas en tu propio sistema en el momento de la compra. El stock local siempre es preferido; el webhook solo llena la escasez.

  • Funciona solo con entrega automática INSTANTÁNEA cuando cada unidad está realmente asignada.
  • Configura un valor predeterminado a nivel de oferta, o anula por opción de precios.
  • Solo HTTPS. La firma HMAC opcional coincide con los webhooks salientes.

Fallos seguros de pago

Si tu punto final se agota o devuelve datos inválidos, el pedido permanece PAGADO. Se cobra al comprador; ves un error en el pedido y puedes reintentar la reserva o adjuntar claves manualmente.

Solicitar contrato

Después del pago, RMT POSTea una llamada reserve.item por cada unidad faltante con pedido, oferta, opción, esquema de campo y cantidad 1. El JSON de plantilla de solicitud opcional se fusiona con {{placeholders}}.

Cuerpo de POST canónico (truncado)

json
{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "…", "reference": "…", "url": "…" },
  "offer": { "url": "…", "title": "…", "pageUrl": "…" },
  "option": { "id": 1, "name": "Estándar" },
  "fields": [{ "id": 10, "name": "Licencia", "type": "text", "required": true }],
  "quantity": 1
}

Respuesta y mapeo de campos

Devuelve JSON 2xx. Mapea rutas como $.license en campos de Item, o devuelve { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }.

Respuesta de conveniencia

json
{
  "entries": [
    { "name": "Licencia", "value": "AAAA-BBBB-CCCC" }
  ]
}
  • Solo licencia: mapea un campo de texto de $.license o $.key.
  • Cuenta: mapea campos de correo electrónico y contraseña de $.email y $.password.
  • Campos requeridos faltantes después del mapeo cuentan como fallo.

Prueba, reintenta y seguridad

Usa Prueba en el editor de ofertas (envía dryRun: true). En la página del pedido, reintenta la reserva después de arreglar tu punto final. Nunca registres secretos o claves completas en correos electrónicos.

  1. 1Guarda la URL HTTPS, el mapa de respuesta y el secreto opcional en el paso de Artículos de la oferta.
  2. 2Ejecuta Prueba y confirma las vistas previas mapeadas.
  3. 3En caso de fallo, abre el pedido, reintenta la reserva o crea/asigna una clave manualmente.

No llames a la reserva antes del pago

RMT solo llama a tu punto final después de que el pago tenga éxito, por lo que los pagos abandonados no queman licencias.