Skip to content
Distribuição multi-passe

Agrupamento de passes para entregar até 10 cartões Wallet de uma só vez

Reúna até 10 passes relacionados do Apple Wallet (.pkpasses) e Google Wallet em uma única entrega para que clientes salvem cartão de membro, voucher ou ingressos em grupo em um único fluxo.

  • Agrupamento AUTO por modelo e vinculados
  • Pacotes MANUAL com nome (até 10 passes)
  • Arquivo .pkpasses iOS e link Google Multi-Save
  • Ordem personalizada, revogação/renovação e PDF
Compatível com:
Apple WalletApple WalletGoogle WalletGoogle Wallet
Pacote multi-passe
3 passes vinculados • 1 salvamento
01Cartão de Membro
Club Atelier Gold
Pontos: 1.240 • Ativo
MEM-4082
MIME: application/vnd.apple.pkpassesPrincipal
02Voucher Boas-Vindas
Bônus Boas-Vindas -€15
Uso único • Sync próprio
OFF-9120
03Passe VIP
Acesso Pré-Estreia
Válido 30 dias • Transferível
VIP-2214
Adicionar todos em 1 toque (iOS)
Máx. 10 passes/pacote
Visão geral

Enviar links ou QR codes separados para cada cartão cria atrito no checkout e na recepção. O agrupamento de passes reúne até 10 credenciais associadas — como cartão de membro com voucher de boas-vindas, ingressos em grupo com estacionamento ou check-in de hotel com acesso ao spa — em um único salvamento.

Use o modo AUTO via configurações do modelo (bundleEnabled, bundleOnDownload e bundlingOrder) ou monte pacotes MANUAL nomeados no painel e na API REST (/api/v1/bundles/upsert). Dentro da carteira, cada pass mantém número de série, código de barras e atualizações independentes via APNs ou Google Wallet.

Modos AUTO e MANUAL

Agrupamento automático por modelo (bundleEnabled / Linked Templates) ou criação manual pelo painel e API REST.

Apple .pkpasses e Google Multi-Save

Envio nativo application/vnd.apple.pkpasses para iOS ou link único JWT assinado do Google Wallet para Android.

Ordem e PDF combinado

Defina o cartão principal com define-order e gere PDF único via GET /bundles/{id}/print-pdf.

Sync individual e gestão em lote

Atualize pontos ou validade por cartão via APNs/Google ou renove e anule o pacote inteiro atomicamente.

1–10
Passes por pacote
.pkpasses
Arquivo nativo Apple
Multi-JWT
Link Google Save
print-pdf
Backup PDF único
Explorador interativo de pacotes

Veja como pacotes multi-passe reais são montados e sincronizados

Agrupe automaticamente o cartão de membro com o voucher de boas-vindas em um único salvamento.

AUTOClique em qualquer pass na ordem do pacote
3/10 passes
Club Atelier Gold (MEM-4082): Cada pass mantém campos próprios, código de barras, push APNs/Google e estatísticas independentes — atualizar um não altera os outros.
# 1) Agrupar até 10 passes em um pacote ordenado
curl -X POST "https://api.passinstance.com/api/v1/bundles/upsert" \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "passes": [
      "b1d972dc-eccf-4f87-ab21-25939d9213d8",
      "c2e083ed-fddf-4a98-bc32-36040e0324e9"
    ],
    "bundleId": "e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b"
  }'

# 2) Baixar arquivo .pkpasses (application/vnd.apple.pkpasses)
curl -L -X GET "https://api.passinstance.com/api/v1/bundles/e5f6a7b8-c9d0-4e1f-8a2b-3c4d5e6f7a8b/download" \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" -o pass-bundle.pkpasses
Envia arquivo .pkpasses assinado para instalar todos os passes no iPhone de uma vez.Ver API de Pacotes
Apple Wallet

Entregue como arquivo .pkpasses com até 10 passes .pkpass assinados.

Google Wallet

Entregue por uma URL JWT assinada que adiciona todo o conjunto no Android.

Recursos

Tudo para implantar seus cartões Wallet em produção

01

Agrupamento AUTO por modelo e Wallet Experience

Ative bundleEnabled / bundleOnDownload ou vincule modelos secundários em uma Wallet Experience para agrupar novos passes automaticamente.

02

Pacotes MANUAL nomeados via painel ou API

Monte conjuntos de até 10 passes com POST /api/v1/bundles ou /api/v1/bundles/upsert para pedidos e reservas.

03

Arquivo nativo Apple Wallet .pkpasses

Transmita um pacote assinado (application/vnd.apple.pkpasses) em GET /api/v1/bundles/{id}/download para instalar tudo no iPhone com um toque.

04

Link único Google Wallet Multi-Save

Gere uma URL JWT assinada (/api/v1/bundles/{id}/google-wallet-link ou ?platform=google) para salvar todos os passes agrupados no Android.

05

Ordem de exibição controlada

Defina bundlingOrder no modelo ou chame POST /api/v1/bundles/{id}/define-order para garantir que o cartão ou ingresso principal abra primeiro.

06

Vincular, remover e desagrupar com segurança

Adicione passes (assign-passes), remova itens específicos (remove-passes) ou desfaça o pacote (unbundle) preservando os passes individuais.

07

PDF combinado pronto para impressão

Exporte todo o pacote em um único PDF via GET /api/v1/bundles/{id}/print-pdf para balcões de atendimento, concierges e cópias em e-mail.

08

Sincronização independente por cartão

Atualize pontos, níveis ou saldos de um único pass via Apple APNs e Google Wallet sem alterar os demais passes do grupo.

09

Renovação, anulação e ações em lote

Prorrogue a validade (/renew), invalide reservas canceladas (/void), automatize operações batch e consulte métricas do pacote (/stats).

Perguntas frequentes

Perguntas frequentes

O que é um pacote de passes e quantos cartões suporta?

É um conjunto nomeado ou automático de 1 a 10 passes Apple Wallet ou Google Wallet para uma jornada do cliente, entregue por um único download ou link de salvamento.

Como funcionam os pacotes no Apple (.pkpasses) e no Google Wallet?

No iOS, a Passinstance envia um arquivo .pkpasses assinado para o Safari adicionar todos os passes juntos. No Android, um único link JWT assinado do Google Wallet salva o conjunto sem aplicativo.

Os passes agrupados continuam sendo atualizados e lidos separadamente?

Sim. O pacote simplifica a entrega inicial, mas cada cartão preserva seu próprio serial, código de barras, leituras e notificações push independentes.

Posso definir a ordem ou alterar um pacote depois de criado?

Sim. Use define-order para ordenar, assign-passes / remove-passes para ajustar os cartões, ou unbundle e DELETE /bundles/{id} mantendo os passes originais.

É possível renovar ou anular um pacote inteiro em uma chamada?

Sim. POST /api/v1/bundles/{id}/renew estende a validade de todos os passes do grupo e sincroniza as carteiras, enquanto POST /api/v1/bundles/{id}/void anula tudo em cancelamentos.

Existe suporte a versão PDF imprimível do pacote?

Sim. GET /api/v1/bundles/{id}/print-pdf reúne todos os cartões do pacote em um único PDF pronto para impressão em balcões ou envio por e-mail.

Entregue pacotes multi-passe completos em um só clique

Comece grátis e orquestre arquivos Apple .pkpasses e links Google Multi-Save sem precisar de aplicativo próprio.