Monetizar passes com o checkout PassFlow
A Passinstance permite que as empresas vendam bilhetes digitais de eventos, credenciais de adesão pagas, passes de acesso VIP e cartões-presente digitais diretamente através de PassFlows (/f/:url). Ao incorporar a cobrança de pagamentos no fluxo de autoinscrição, pode aceitar pagamentos e emitir passes Apple Wallet e Google Wallet assinados criptograficamente numa única transação sem fricção.
Fornecedores e métodos de pagamento suportados
A Passinstance suporta gateways de pagamento globais e regionais através de IPublicPassFlowPaymentConfig:
| Fornecedor | Métodos suportados | Moedas suportadas | Ideal para |
|---|---|---|---|
| Stripe | Cartões de Crédito/Débito, Apple Pay, Google Pay, Débito Direto SEPA, iDEAL, Bancontact | Mais de 135 moedas (EUR, USD, GBP, etc.) | Comércio eletrónico global, carteiras móveis e débitos diretos europeus |
| PayPal | Saldo PayPal, Cartões de Crédito, Pay in 4, Venmo | Mais de 25 moedas globais | Elevado reconhecimento de marca e checkout PayPal de um clique sem fricção |
| Paystack | Cartões Locais, Transferências Bancárias, USSD, Apple Pay | NGN, GHS, ZAR, KES | Mercados africanos e operações de pagamento pan-africanas |
| Mobile Money | MTN MoMo, Orange Money, M-Pesa | Moedas móveis locais africanas | Inscrição de consumidores mobile-first em mercados emergentes |
Configuração passo a passo: Criar um PassFlow pago
Para configurar a inscrição paga de passes para qualquer modelo:
Passo 1: Ligar a sua gateway de pagamentos
Antes de configurar o preço do passe, ligue o seu fornecedor de pagamentos:
-
1
No Painel, aceda a Definições -> Integrações -> Pagamentos (
/settings/integrations/payments). -
2
Clique em Ligar em Stripe, PayPal ou Paystack.
-
3
Introduza as suas chaves de API de produção ou conclua o fluxo de integração OAuth.
Passo 2: Abrir o construtor PassFlow
-
1
Aceda a Passes -> PassFlows e selecione o fluxo associado ao seu modelo (ou crie um novo fluxo).
-
2
Na sequência de etapas do fluxo, garanta a seguinte ordem:
- FormStep (Dados do Cliente) - EmailStep ou OtpStep (Verificação opcional) - PaymentStep (Cobrança de Pagamento) - PassStep (Entrega do Passe)
Passo 3: Configurar o preço e a moeda do passe
Clique no bloco PaymentStep para configurar as propriedades do checkout:
-
Preço (
amount): Defina o preço do passe (por exemplo,25.00). -
Moeda (
currency): Selecione a moeda de liquidação (por exemplo,EUR,USD). -
Nome e Descrição do Item: Introduza o título apresentado aos clientes na página de checkout (por exemplo, "Adesão Anual Lounge VIP 2026").
-
Fornecedores de Pagamento: Assinale quais as gateways ligadas que pretende disponibilizar (por exemplo, ativar Stripe e PayPal em simultâneo).
Passo 4: Mapear metadados de pagamento para atributos do passe
Pode associar automaticamente os dados de confirmação do pagamento a campos personalizados do passe:
-
Utilize
{transactionId}para captar o ID de referência da gateway de pagamentos. -
Utilize
{amountPaid}para apresentar o preço do bilhete adquirido nos campos do verso do passe. -
Utilize
{paymentDate}para registar o carimbo temporal da compra.
Passo 5: Publicar e testar o seu fluxo
Abra a sua ligação pública PassFlow (/f/:slug) numa janela anónima:
-
1
Preencha os dados de um cliente de teste.
-
2
Conclua um pagamento de teste utilizando cartões de teste da gateway ou credenciais Sandbox do PayPal.
-
3
Confirme que o passe é emitido imediatamente no ecrã
PassStep.
Endpoints públicos da API REST de checkout
Se estiver a incorporar a compra de passes na sua própria aplicação móvel, website ou frontend React personalizado, pode interagir diretamente com os endpoints públicos de pagamento do PassFlow:
| Método | Caminho do endpoint | Descrição |
|---|---|---|
| GET | /api/v1/pass-flows/public/:url/payment-config | Devolve a configuração de pagamento: gateways ativadas, moeda, montante do preço e chaves públicas de API. |
| POST | /api/v1/pass-flows/public/:url/payment-intent | Cria um PaymentIntent Stripe e devolve clientSecret para Stripe Elements. |
| POST | /api/v1/pass-flows/public/:url/paypal-order | Cria uma Order PayPal v2 e devolve o URL de aprovação PayPal. |
| POST | /api/v1/pass-flows/public/:url/paystack/initialize | Inicializa uma transação Paystack e devolve um URL de autorização. |
| POST | /api/v1/pass-flows/public/:url/mtn-momo/request-to-pay | Aciona um pedido de pagamento push para um número de telefone MTN Mobile Money. |
Exemplo: Inicializar um Payment Intent da 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"
}
}
Resposta (200 OK):
{
"clientSecret": "pi_3Q9xZ2eZvKYlo2C11223344_secret_R1a2B3c4D5e6F7g8",
"publishableKey": "pk_live_51H...",
"amount": 4900,
"currency": "EUR",
"flowSessionId": "flow_sess_01j9x87k1"
}
Gerir reembolsos, disputas e revogação de passes
Quando um cliente solicita um reembolso ou contesta uma cobrança através da Stripe ou do PayPal:
-
1
Processamento Automático de Webhooks: A Passinstance recebe o webhook
charge.refundedouPAYMENT.CAPTURE.REFUNDED. -
2
Opção de Revogação do Passe: Em Definições do Espaço de Trabalho -> Pagamentos, pode configurar a política automática de reembolsos:
- Anular Passe Automaticamente (Recomendado): Define pass.voided = true. A Apple Wallet coloca imediatamente uma faixa "Anulado" sobre o passe e risca o código de barras. A Google Wallet marca o passe como inativo. Os dispositivos de leitura rejeitam futuras tentativas de check-in. - Manter Passe: Mantém o passe ativo e guarda um registo de auditoria para revisão manual pela equipa.
-
3
Alerta por Notificação Push: Quando o passe é anulado, a Passinstance envia uma notificação push APNs e Google Wallet a informar o titular de que a sua credencial foi revogada devido a reembolso.
Documentação relacionada
-
Vender subscrições — Adesões recorrentes e sincronização automática de renovações de faturação.
-
Solicitar uma assinatura de API PayPal — Ligar credenciais REST OAuth do PayPal.
-
Distribuição em autoatendimento — PassFlows, ligações inteligentes e inscrição NFC.
-
Formulários de registo e PassFlow — Configurações de etapas, proteção contra bots e validação de formulários.
