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

Vender pases

Monetice pases de billetera digital con el proceso de pago de PassFlow, conectando Stripe, PayPal o Paystack para la emisión instantánea tras el pago.

En esta guía

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.

FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
REGISTRO DE PASE DE PAGO Y EMISIÓN POR WEBHOOK
ETAPA 01 NAVEGADOR DEL CLIENTE (PASSFLOW /f/:slug)
1
FormStep: El cliente introduce nombre, correo, teléfono y atributos propios
2
OtpStep (Opcional): Verifica correo o móvil con un código de 6 dígitos
3
PaymentStep: Muestra precio, resumen del artículo y elementos de pago
ETAPA 02 PASARELA DE PAGOS (STRIPE / PAYPAL / PAYSTACK)
Procesa autenticación 3D-Secure 2, Apple Pay, Google Pay o PayPal
Confirma el cargo y emite el evento de captura
ETAPA 03 MOTOR DE WEBHOOKS DE PAGO Y EMISIÓN DE PASSINSTANCE
Verifica criptográficamente la firma (Stripe-Signature / PayPal)
Crea idempotentemente el registro Pass en base de datos (estado ACTIVE)
Inyecta metadatos de pago (transactionId, amountPaid, currency) en atributos
ETAPA 04 AÑADIDO INSTANTÁNEO AL MONEDERO (PASSSTEP)
El cliente añade el pase al instante con [Añadir a Apple Wallet] / [Google]

Proveedores y métodos de pago admitidos

Passinstance admite pasarelas de pago globales y regionales a través de IPublicPassFlowPaymentConfig:

ProveedorMétodos admitidosDivisas admitidasIdeal para
StripeTarjetas de crédito/débito, Apple Pay, Google Pay, adeudo directo SEPA, iDEAL, BancontactMás de 135 divisas (EUR, USD, GBP, etc.)Comercio electrónico global, monederos móviles y adeudos directos europeos
PayPalSaldo PayPal, tarjetas de crédito, Pay in 4, VenmoMás de 25 divisas globalesAlto reconocimiento de marca y pago ágil con PayPal en un clic
PaystackTarjetas locales, transferencias bancarias, USSD, Apple PayNGN, GHS, ZAR, KESMercados africanos y operaciones de pago panafricanas
Mobile MoneyMTN MoMo, Orange Money, M-PesaDivisas móviles africanas localesRegistro 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. 1
    En el panel de control, vaya a Configuración -> Integraciones -> Pagos (/settings/integrations/payments).
  2. 2
    Haga clic en Conectar en Stripe, PayPal o Paystack.
  3. 3
    Introduzca sus claves API de producción o complete el proceso de alta mediante OAuth.

Paso 2: abra el constructor de PassFlow

  1. 1
    Vaya a Pases -> PassFlows y seleccione el flujo vinculado a su plantilla (o cree uno nuevo).
  2. 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. 1
    Rellene datos de cliente de prueba.
  2. 2
    Complete un pago de prueba utilizando tarjetas de prueba de la pasarela o credenciales Sandbox de PayPal.
  3. 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étodoRuta del endpointDescripción
GET/api/v1/pass-flows/public/:url/payment-configDevuelve la configuración de pagos: pasarelas habilitadas, divisa, importe y claves API públicas.
POST/api/v1/pass-flows/public/:url/payment-intentCrea un PaymentIntent de Stripe y devuelve clientSecret para Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderCrea una orden PayPal v2 y devuelve la URL de aprobación de PayPal.
POST/api/v1/pass-flows/public/:url/paystack/initializeInicializa una transacción de Paystack y devuelve una URL de autorización.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payEnvía una solicitud de pago push a un número de teléfono MTN Mobile Money.

Ejemplo: inicializar un Payment Intent de Stripe

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

JSON
{
  "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. 1
    Procesamiento automático por webhook: Passinstance recibe el webhook charge.refunded o PAYMENT.CAPTURE.REFUNDED.
  2. 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.

  1. 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

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.