Permita que los clientes se registren solos 24/7
Más allá de subir listados CSV o invocar API de backend, Passinstance le permite publicar puntos de registro autoservicio sin autenticación previa en mostradores físicos, páginas de confirmación de pedidos en comercio electrónico, recibos y embalajes de productos:
| Canal | Ideal para | Cómo funciona |
|---|---|---|
| Formulario público PassFlow | Carteles en mostrador, firmas de correo, folletos con QR | El cliente rellena un formulario adaptado a móvil (/p/:url), verifica OTP por correo/SMS si está activado, completa un pago opcional y guarda su pase al instante. |
| Botón / Widget incrustado de Wallet | Portales de cuenta de clientes, páginas de confirmación de compra | Incruste un iframe interactivo o un widget script de Añadir al monedero directamente en el HTML de su sitio web. |
| URL dinámica de monedero | Correos transaccionales, paneles SaaS, portales de fidelización | Firme o pase atributos parametrizados del cliente en la URL o mediante upsert-by-external-id para que usuarios autenticados obtengan una tarjeta ya cumplimentada en un toque. |
| Etiqueta inteligente NFC NDEF | Expositores de mesa, mostradores de caja, pósteres inteligentes | Grabe una URL pública de PassFlow en cualquier etiqueta NFC NDEF estándar (NTAG213/215) para que acercar un iPhone o Android abra el flujo de registro sin escanear un QR. |
Arquitectura de autoregistro público en PassFlow
El motor PassFlow (PassFlow API en /api/v1/pass-flows/public/:url, con alias /api/v1/passflows/public/:url y ruta de interfaz /f/:url) orquesta la captura multipaso sin autenticación (PassFlowType, PassFlowSubmissionStatus) con protección anti-bots integrada (SpamProtectionMode), verificación OTP, prevención de duplicados (externalId) y entrega inmediata al monedero:
Importante: Para evitar emitir pases duplicados cuando un socio ya existente vuelve a enviar un formulario autoservicio, configure Reglas de deduplicación / ID externo en su plantilla o PassFlow (
phoneoexternalId). Los portales backend también pueden invocarPOST /api/v1/passes/upsert-by-external-iddirectamente para devolver el pase activo existente en lugar de generar un registro duplicado.
Referencia de la API pública de PassFlow y autoservicio
| Método | Ruta del endpoint | Ámbito de auth | Descripción | ||
|---|---|---|---|---|---|
| GET | /api/v1/pass-flows/public/:url | Público | Recupera la configuración pública de pasos del PassFlow (PassFlowStepType), esquema del formulario, tema (page theme: `LIGHT \ | DARK \ | CUSTOM`) y metadatos de vista previa de la plantilla. |
| GET | /api/v1/pass-flows/public/:url/csrf-token | Público | Emite el token anti-CSRF requerido antes de enviar solicitudes públicas de generación de pase. | ||
| POST | /api/v1/pass-flows/public/:url/generate | Público | Envía el payload de registro (request payload: userData, recaptchaToken?, botProtectionToken?) para crear u obtener el pase. | ||
| POST | /api/v1/pass-flows/public/:url/otp/send | Público (con límite de tasa) | Envía un código de verificación de un solo uso (POST .../otp/resend para reenviar) durante OtpStep. | ||
| POST | /api/v1/pass-flows/public/:url/otp/verify | Público (con límite de tasa) | Verifica el código OTP enviado y desbloquea la generación del pase. | ||
| POST | /api/v1/pass-flows/public/:url/payment-intent | Público | Inicializa un PaymentIntent de Stripe (GET .../payment-config, /paypal-order, /paystack/initialize, /mtn-momo/request-to-pay, /orange-money/initiate). | ||
| POST | /api/v1/passes/upsert-by-external-id | Clave API (passes) | request payload — crea (CREATED) o actualiza (UPDATED) de manera idempotente el pase de un cliente indexado por externalId. |
Ejemplo: registro idempotente desde portal mediante upsert-by-external-id
Cuando integre un botón Añadir al monedero dentro de su propio portal autenticado de clientes o aplicación web, invoque POST /api/v1/passes/upsert-by-external-id en su backend y redirija al usuario a passAccessUrl:
POST /api/v1/passes/upsert-by-external-id
{
"templateId": "7b9e4c12-3f81-4a90-b8d2-19c48a70e112",
"externalId": "USR-90214",
"status": "ACTIVE",
"attributes": {
"firstName": "Elena",
"lastName": "Rostova",
"email": "elena.rostova@example.com",
"tier": "Gold",
"points": 1250
}
}
Respuesta (200 OK):
{
"success": true,
"data": {
"pass": {
"id": "c41a8d20-6e11-4f3b-9a81-0029d81a4f10",
"serialNumber": "PI-8849-2026-X9",
"externalId": "USR-90214",
"bundleId": null,
"status": "ACTIVE",
"walletVoidStatus": "QUEUED",
"passAccessUrl": "https://app.passinstance.com/p/c41a8d20-6e11-4f3b-9a81-0029d81a4f10"
},
"action": "UPDATED"
},
"description": "Pass updated successfully",
"errors": [],
"statusCode": 200
}
Codificación de etiquetas NFC NDEF de mostrador
Para desplegar expositores físicos de registro por proximidad en mostradores de caja sin necesidad de lectores hardware Apple VAS o Google Smart Tap:
-
1
Copie su URL pública de PassFlow (por ejemplo,
https://app.passinstance.com/f/coffee-club-vip). -
2
Utilice cualquier aplicación estándar de escritura NFC (como NFC Tools) para grabar un NDEF URI Record en una etiqueta NTAG213, NTAG215 o NTAG216 y active Lock Tag (Solo lectura) para que los clientes no puedan sobrescribir la URL.
-
3
Cuando un cliente acerca su iPhone o teléfono Android desbloqueado al expositor, el sistema operativo abre automáticamente la página de registro de PassFlow en Safari o Chrome.
Consulte la guía Formularios de registro y PassFlow y la Guía de integraciones para parámetros de incrustación y disparadores de webhooks.
