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

Formularios de registro y PassFlow

Configura los pasos de alta en PassFlow (formulario, captura de correo, verificación OTP opcional).

En esta guía

Descripción general

PassFlow (PassFlow API montado en /api/v1/pass-flows, alias /api/v1/passflows) es el motor de registro y pago autoservicio de marca blanca alojado por Passinstance (PassFlowType: REGISTRATION, CHECKOUT, RECHARGE, CLAIM, UPDATE, REDEMPTION, CUSTOM; PassFlowStatus: DRAFT, PUBLISHED, PAUSED, ARCHIVED). Los clientes visitan /f/:url, completan pasos configurables de captura —incluidos campos de formulario personalizados, protección anti-bots (SpamProtectionMode: NONE, RECAPTCHA), verificación OTP por correo/SMS y pasarela de pago opcional— e instalan de inmediato su pase en Apple Wallet o Google Wallet.

Arquitectura del sistema: flujo PassFlow y pasarelas de pago

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
REGISTRO EN PASSFLOW, OTP Y MOTOR DE PAGOS
ETAPA 01 CLIENTE PÚBLICO PASSFLOW (/f/:url)
1
FormStep
Props. pers. y validación
2
EmailStep
Identidad y consent. RGPD
3
OtpStep
Código 6 díg.
SMS / Email
4
PaymentStep (Pago opcional de pases de pago)
5
PassStep .pkpass de Apple y JWT Save Google
ETAPA 02 BACKEND PASSFLOW Y ORQUESTADOR DE PASARELAS DE PAGO
Generar pase: POST/api/v1/pass-flows/public/:url/generate
Envío/Verif OTP: POST.../otp/send, POST.../otp/resend, POST.../otp/verify
Stripe: POST/api/v1/pass-flows/public/:url/payment-intent
PayPal: POST/api/v1/pass-flows/public/:url/paypal-order
Paystack: POST/api/v1/pass-flows/public/:url/paystack/initialize
MTN MoMo: POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-pay
Orange Money: POST/api/v1/pass-flows/public/:url/orange-money/initiate

Pasos de PassFlow y máquina de estados de envíos

En Passinstance Dashboard y PassFlow API (PassFlowStepType: INTRODUCTION, FORM, PASS_LOOKUP, AUTHENTICATION, PRODUCT_SELECTION, PAYMENT, REVIEW, PROCESSING, CONFIRMATION, PASS_DELIVERY, ERROR, CUSTOM):

Paso público (stepFlow.ts)Nombre de etapaComportamiento de ejecución y reglas de validación
1. FormStepFormulario de registro de clienteMuestra las propiedades visibles de la plantilla con validación de obligatoriedad/regex y casillas de consentimiento RGPD. Llama a GET /api/v1/pass-flows/public/:url/csrf-token antes de enviar POST /api/v1/pass-flows/public/:url/generate (userData, recaptchaToken?).
2. EmailStepContacto y deduplicaciónCaptura o confirma el correo electrónico o teléfono principal y aplica los ajustes de externalId / deduplicación.
3. OtpStepVerificación mediante código de un solo uso(Opcional) Envía y verifica un OTP con validez temporal mediante POST /api/v1/pass-flows/public/:url/otp/send, /otp/resend y /otp/verify.
4. PaymentStepPasarela de pago integrada(Opcional) Lee GET /api/v1/pass-flows/public/:url/payment-config y cobra mediante Stripe, PayPal, Paystack, MTN Mobile Money u Orange Money.
5. PassStepEntrega instantánea al monederoMuestra los botones Añadir a Apple Wallet / Añadir a Google Wallet, entrega mediante código QR y superposiciones guiadas PassTour.

Importante: Los envíos registran PassFlowSubmissionStatus (STARTED, SUBMITTED, AWAITING_PAYMENT, PAYMENT_PENDING, PROCESSING, COMPLETED, FAILED, REJECTED, EXPIRED, CANCELLED). Cuando la verificación OTP o el pago están activados, la activación del pase en el monedero se produce únicamente tras confirmarse correctamente la verificación.

Pasarelas de pago integradas para pases de pago

PassFlow admite cinco procesadores de pago regionales y globales con endpoints públicos dedicados de inicialización y webhooks:

Proveedor de pagosEndpoint público de inicializaciónMétodos de pago y regiones admitidos
StripePOST /api/v1/pass-flows/public/:url/payment-intentTarjetas de crédito/débito, Apple Pay, Google Pay, SEPA, Klarna (Global)
PayPalPOST /api/v1/pass-flows/public/:url/paypal-orderPayPal Wallet, Pay Later, Venmo (Global)
PaystackPOST /api/v1/pass-flows/public/:url/paystack/initializeTarjetas, transferencia bancaria, USSD, Mobile Money (Nigeria, Ghana, Kenia, Sudáfrica)
MTN Mobile MoneyPOST /api/v1/pass-flows/public/:url/mtn-momo/request-to-payAprobación push USSD en monedero móvil (África Occidental y Central)
Orange MoneyPOST /api/v1/pass-flows/public/:url/orange-money/initiatePago web/móvil OTP con Orange Money (África francófona y Europa)

Ejemplo: inicializar un Payment Intent de Stripe en PassFlow

POST /api/v1/pass-flows/public/summer-vip-festival/payment-intent
Cabeceras
Content-Type application/json
JSON
{
  "email": "claire.dubois@example.com",
  "userData": {
    "firstName": "Claire",
    "lastName": "Dubois",
    "ticketTier": "VIP All-Access"
  }
}

Respuesta HTTP (201 Created)

JSON
{
  "success": true,
  "data": {
    "clientSecret": "pi_3Q9xYz2eZvKYlo2C1a2b3c4d_secret_9f8e7d6c5b4a",
    "paymentIntentId": "pi_3Q9xYz2eZvKYlo2C1a2b3c4d"
  },
  "statusCode": 201
}

Ejemplo: iniciar un Request-to-Pay con MTN MoMo

POST /api/v1/pass-flows/public/accra-vip-lounge/mtn-momo/request-to-pay
Cabeceras
Content-Type application/json
JSON
{
  "phoneNumber": "+233241234567",
  "amount": 150,
  "currency": "GHS"
}

Gestión de PassFlows en el panel y la API

Configure PassFlows alojados en el panel bajo Distribución -> Pass Flows (/pass-flows) o gestiónelos de forma programática mediante /api/v1/pass-flows:

  • GET /api/v1/pass-flows: Lista todos los PassFlows configurados en el espacio de trabajo activo.
  • POST /api/v1/pass-flows: Crea un nuevo PassFlow vinculado a una templateId publicada, definiendo el slug url, PassFlowType, ajustes OTP y configuración de pago.
  • PATCH /api/v1/pass-flows/:id: Actualiza la visibilidad de los campos del formulario, requisitos OTP o configuración de pasarela de pago.

Obtenga más información sobre los canales públicos de distribución en Distribución en autoservicio y Enlaces de descarga y PassFlow.

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.