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)
{
"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
{
"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.
- 1Guarda la URL HTTPS, el mapa de respuesta y el secreto opcional en el paso de Artículos de la oferta.
- 2Ejecuta Prueba y confirma las vistas previas mapeadas.
- 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.