Monetización de pases con el proceso de pago de PassFlow
Passinstance permite a las empresas vender entradas digitales para eventos, credenciales de membresía de pago, pases de acceso VIP y tarjetas regalo digitales directamente a través de PassFlows (/f/:url). Al integrar el cobro dentro del flujo de registro en autoservicio, puede aceptar pagos y emitir pases firmados criptográficamente para Apple Wallet y Google Wallet en una sola transacción sin fricciones.
Proveedores y métodos de pago admitidos
Passinstance admite pasarelas de pago globales y regionales a través de IPublicPassFlowPaymentConfig:
| Proveedor | Métodos admitidos | Divisas admitidas | Ideal para |
|---|---|---|---|
| Stripe | Tarjetas de crédito/débito, Apple Pay, Google Pay, adeudo directo SEPA, iDEAL, Bancontact | Más de 135 divisas (EUR, USD, GBP, etc.) | Comercio electrónico global, monederos móviles y adeudos directos europeos |
| PayPal | Saldo PayPal, tarjetas de crédito, Pay in 4, Venmo | Más de 25 divisas globales | Alto reconocimiento de marca y pago ágil con PayPal en un clic |
| Paystack | Tarjetas locales, transferencias bancarias, USSD, Apple Pay | NGN, GHS, ZAR, KES | Mercados africanos y operaciones de pago panafricanas |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Divisas móviles africanas locales | Registro móvil prioritario de consumidores en mercados emergentes |
Configuración paso a paso: crear un PassFlow de pago
Para configurar el registro de pases de pago en cualquier plantilla:
Paso 1: conecte su pasarela de pagos
Antes de establecer el precio del pase, conecte su proveedor de pagos:
-
1
En el panel de control, vaya a Configuración -> Integraciones -> Pagos (
/settings/integrations/payments). -
2
Haga clic en Conectar en Stripe, PayPal o Paystack.
-
3
Introduzca sus claves API de producción o complete el proceso de alta mediante OAuth.
Paso 2: abra el constructor de PassFlow
-
1
Vaya a Pases -> PassFlows y seleccione el flujo vinculado a su plantilla (o cree uno nuevo).
-
2
En la secuencia de pasos del flujo, asegúrese de mantener este orden:
- FormStep (Datos del cliente) - EmailStep o OtpStep (Verificación opcional) - PaymentStep (Cobro del pago) - PassStep (Entrega del pase)
Paso 3: configure el precio y la divisa del pase
Haga clic en el bloque PaymentStep para configurar las propiedades del pago:
-
Precio (
amount): Defina el importe del pase (por ejemplo,25.00). -
Divisa (
currency): Seleccione la divisa de liquidación (por ejemplo,EUR,USD). -
Nombre y descripción del artículo: Introduzca el título que verán los clientes en la página de pago (por ejemplo, "Membresía anual VIP Lounge 2026").
-
Proveedores de pago: Marque qué pasarelas conectadas desea ofrecer (por ejemplo, habilitar tanto Stripe como PayPal).
Paso 4: asigne los metadatos de pago a atributos del pase
Puede vincular automáticamente los detalles de confirmación del pago a campos personalizados del pase:
-
Use
{transactionId}para capturar el ID de referencia de la pasarela de pagos. -
Use
{amountPaid}para mostrar el precio de la entrada adquirida en el reverso del pase. -
Use
{paymentDate}para registrar la marca temporal de la compra.
Paso 5: publique y pruebe su flujo
Abra el enlace público de su PassFlow (/f/:slug) en una ventana de incógnito:
-
1
Rellene datos de cliente de prueba.
-
2
Complete un pago de prueba utilizando tarjetas de prueba de la pasarela o credenciales Sandbox de PayPal.
-
3
Compruebe que el pase se genera de inmediato en la pantalla
PassStep.
Endpoints de la API REST de pago público
Si está integrando la compra de pases dentro de su propia aplicación móvil, sitio web o frontend en React, puede interactuar directamente con los endpoints públicos de pago de PassFlow:
| Método | Ruta del endpoint | Descripción |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Devuelve la configuración de pagos: pasarelas habilitadas, divisa, importe y claves API públicas. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Crea un PaymentIntent de Stripe y devuelve clientSecret para Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Crea una orden PayPal v2 y devuelve la URL de aprobación de PayPal. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Inicializa una transacción de Paystack y devuelve una URL de autorización. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Envía una solicitud de pago push a un número de teléfono MTN Mobile Money. |
Ejemplo: inicializar un Payment Intent de Stripe
POST /api/v1/pass-flows/public/vip-membership-2026/payment-intent HTTP/1.1
Host: api.passinstance.com
Content-Type: application/json
{
"email": "customer@example.com",
"name": "Jordan Lee",
"attributes": {
"tier": "Gold VIP",
"seatNumber": "Row A, Seat 12"
}
}
Respuesta (200 OK):
{
"clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
"publishableKey": "pk_live_51H...",
"amount": 4900,
"currency": "EUR",
"flowSessionId": "flow_sess_01j9x87k1"
}
Gestión de reembolsos, disputas y revocación de pases
Cuando un cliente solicita un reembolso o abre una disputa a través de Stripe o PayPal:
-
1
Procesamiento automático por webhook: Passinstance recibe el webhook
charge.refundedoPAYMENT.CAPTURE.REFUNDED. -
2
Opción de revocación del pase: En Configuración del espacio de trabajo -> Pagos, puede configurar la política automática de reembolsos:
- Anular pase automáticamente (Recomendado): Establece pass.voided = true. Apple Wallet coloca de inmediato una banda de "Anulado" sobre el pase y tacha el código de barras. Google Wallet marca el pase como inactivo. Los dispositivos de escaneo rechazan futuros intentos de acceso. - Conservar pase: Mantiene el pase activo y genera un registro de auditoría para su revisión manual por el personal.
-
3
Alerta mediante notificación push: Al anular el pase, Passinstance envía una notificación push vía APNs y Google Wallet informando al titular de que su credencial ha sido revocada debido a un reembolso.
Documentación relacionada
-
Venta de suscripciones — Membresías recurrentes y sincronización automática de renovaciones.
-
Solicitar una firma API de PayPal — Conexión de credenciales OAuth REST de PayPal.
-
Distribución en autoservicio — PassFlows, enlaces inteligentes y registro mediante NFC.
-
Formularios de registro y PassFlow — Configuración de pasos, protección antibots y validación de formularios.
