Skip to content
Guía del Centro de ayuda · Distribución de pases
4 min de lecturaVerificado 2026-11-16

Distribución autoservicio

Publica enlaces PassFlow públicos, widgets embebibles, URL dinámicas y etiquetas NFC NDEF en tienda.

En esta guía

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:

CanalIdeal paraCómo funciona
Formulario público PassFlowCarteles en mostrador, firmas de correo, folletos con QREl 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 WalletPortales de cuenta de clientes, páginas de confirmación de compraIncruste un iframe interactivo o un widget script de Añadir al monedero directamente en el HTML de su sitio web.
URL dinámica de monederoCorreos transaccionales, paneles SaaS, portales de fidelizaciónFirme 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 NDEFExpositores de mesa, mostradores de caja, pósteres inteligentesGrabe 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:

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
AUTOREGISTRO PÚBLICO PASSFLOW
ETAPA 01 PUNTO DE ENTRADA DEL CLIENTE (QR / URL / NFC NDEF)
GET/api/v1/pass-flows/public/:url (Carga esquema del flujo)
ETAPA 02 PASO 1: FormStep (Atributos del cliente y validación de consentimiento)
Obtiene token CSRF (/csrf-token) y valida request payload
ETAPA 03 PASOS 2 Y 3: EmailStep / OtpStep (Verificación de identidad opcional)
Envía código de verificación vía POST/api/v1/pass-flows/public/:url/otp/send
Verifica token OTP vía POST/api/v1/pass-flows/public/:url/otp/verify
ETAPA 04 PASO 4: PaymentStep (Opcional: membresías, tarjetas regalo y entradas de pago)
Admite Stripe PaymentIntent, PayPal Orders, Paystack, MTN MoMo, Orange Money
ETAPA 05 PASO 5: PassStep (Upsert idempotente y entrega inmediata al monedero)
Deduplica por email/teléfono/externalId (semántica upsert-by-external-id)
Muestra botón .pkpass Apple Wallet, Save JWT Google Wallet y código QR

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 (email, phone o externalId). Los portales backend también pueden invocar POST /api/v1/passes/upsert-by-external-id directamente para devolver el pase activo existente en lugar de generar un registro duplicado.

Referencia de la API pública de PassFlow y autoservicio

MétodoRuta del endpointÁmbito de authDescripción
GET/api/v1/pass-flows/public/:urlPúblicoRecupera 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-tokenPúblicoEmite el token anti-CSRF requerido antes de enviar solicitudes públicas de generación de pase.
POST/api/v1/pass-flows/public/:url/generatePúblicoEnvía el payload de registro (request payload: userData, recaptchaToken?, botProtectionToken?) para crear u obtener el pase.
POST/api/v1/pass-flows/public/:url/otp/sendPú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/verifyPú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-intentPúblicoInicializa 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-idClave 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:

JSON
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):

JSON
{
  "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. 1
    Copie su URL pública de PassFlow (por ejemplo, https://app.passinstance.com/f/coffee-club-vip).
  2. 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. 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.

Documentación de producto y API relacionada

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.