Skip to content
Guia da Central de Ajuda · Distribuição de passes
5 min de leituraVerificado 2026-11-16

Vender passes

Monetize passes de carteira digital com o checkout do PassFlow, conectando Stripe, PayPal ou Paystack para emissão instantânea após o pagamento.

Neste guia

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.

FLUXO DE ARQUITETURA
ARQUITETURA INTERATIVA
INSCRIÇÃO PAGA E EMISSÃO VIA WEBHOOK
ETAPA 01 NAVEGADOR DO CLIENTE (PASSFLOW /f/:slug)
1
FormStep: Cliente introduz nome, e-mail, telemóvel e atributos
2
OtpStep (Opcional): Verifica e-mail ou telemóvel com código de 6 dígitos
3
PaymentStep: Apresenta preço, resumo do item e elementos de pagamento
ETAPA 02 GATEWAY DE PAGAMENTOS (STRIPE / PAYPAL / PAYSTACK)
Processa autenticação de cartão 3D-Secure 2, Apple Pay, Google Pay ou PayPal
Confirma a cobrança e emite evento de captura
ETAPA 03 MOTOR DE WEBHOOKS DE PAGAMENTO E EMISSÃO PASSINSTANCE
Verifica criptograficamente a assinatura do webhook (Stripe-Signature/PayPal)
Cria de forma idempotente o registo Pass na BD (estado ACTIVE)
Injeta metadados de pagamento (transactionId, amountPaid, currency) nos atrib.
ETAPA 04 ADIÇÃO IMEDIATA À CARTEIRA (PASSSTEP)
Cliente adiciona logo o passe via [Adicionar à Apple Wallet] e [Guardar Google]

Fornecedores e métodos de pagamento suportados

A Passinstance suporta gateways de pagamento globais e regionais através de IPublicPassFlowPaymentConfig:

FornecedorMétodos suportadosMoedas suportadasIdeal para
StripeCartões de Crédito/Débito, Apple Pay, Google Pay, Débito Direto SEPA, iDEAL, BancontactMais de 135 moedas (EUR, USD, GBP, etc.)Comércio eletrónico global, carteiras móveis e débitos diretos europeus
PayPalSaldo PayPal, Cartões de Crédito, Pay in 4, VenmoMais de 25 moedas globaisElevado reconhecimento de marca e checkout PayPal de um clique sem fricção
PaystackCartões Locais, Transferências Bancárias, USSD, Apple PayNGN, GHS, ZAR, KESMercados africanos e operações de pagamento pan-africanas
Mobile MoneyMTN MoMo, Orange Money, M-PesaMoedas móveis locais africanasInscriçã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. 1
    No Painel, aceda a Definições -> Integrações -> Pagamentos (/settings/integrations/payments).
  2. 2
    Clique em Ligar em Stripe, PayPal ou Paystack.
  3. 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. 1
    Aceda a Passes -> PassFlows e selecione o fluxo associado ao seu modelo (ou crie um novo fluxo).
  2. 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. 1
    Preencha os dados de um cliente de teste.
  2. 2
    Conclua um pagamento de teste utilizando cartões de teste da gateway ou credenciais Sandbox do PayPal.
  3. 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étodoCaminho do endpointDescrição
GET/api/v1/pass-flows/public/:url/payment-configDevolve 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-intentCria um PaymentIntent Stripe e devolve clientSecret para Stripe Elements.
POST/api/v1/pass-flows/public/:url/paypal-orderCria uma Order PayPal v2 e devolve o URL de aprovação PayPal.
POST/api/v1/pass-flows/public/:url/paystack/initializeInicializa uma transação Paystack e devolve um URL de autorização.
POST/api/v1/pass-flows/public/:url/mtn-momo/request-to-payAciona um pedido de pagamento push para um número de telefone MTN Mobile Money.

Exemplo: Inicializar um Payment Intent da 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"
  }
}

Resposta (200 OK):

JSON
{
  "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. 1
    Processamento Automático de Webhooks: A Passinstance recebe o webhook charge.refunded ou PAYMENT.CAPTURE.REFUNDED.
  2. 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.

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

Documentação de produto e API relacionada

Pronto para lançar o seu primeiro programa de cartões Wallet?

Crie o seu espaço de trabalho, configure o seu modelo e teste um cartão real na Apple Wallet e Google Wallet antes de escalar.