Skip to content
Apple Wallet

API para cartões Apple Wallet

Emita, assine e atualize arquivos .pkpass nativos para iOS e watchOS via API REST. Gestão de certificados e alertas APNs automáticos.

  • Geração de .pkpass assinados
  • Gestão automática de certificados WWDR
  • Notificações push APNs na tela
  • SDK TypeScript / Node.js
Compatível com:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Explorador da API REST Passinstance

Exemplo ilustrativo

Solicitações e respostas de exemplo. Nenhuma chamada à API é enviada.

POST/api/v1/passes
Emita um passe personalizado para Apple Wallet e Google Wallet com links diretos para download.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Resposta de exemplo
201 Created
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Visão geral

A API Apple Wallet do Passinstance permite gerar e atualizar cartões .pkpass sem configurar contas de desenvolvedor Apple ou servidores de push.

Suporta cartões de fidelidade, cupons, ingressos e membros com atualizações automáticas via chamadas HTTP REST.

Recursos

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

01

Assinatura e entrega de arquivos .pkpass

Gere pacotes assinados criptograficamente prontos para iPhone e Apple Watch.

02

Infraestrutura push APNs

Acione alertas nativos na tela de bloqueio quando os dados do cartão mudarem.

03

API de cartões wallet

Crie, atualize e revogue cartões programaticamente com uma API REST e webhooks para eventos em tempo real.

04

Códigos QR e links de download

Distribua cartões via páginas hospedadas, códigos QR, e-mail, SMS ou PDV — instalação em um toque sem app.

05

Notificações de atualização

Envie notificações na tela de bloqueio quando houver alterações de saldo, nível ou ofertas em tempo real.

06

Geolocalização e locais relevantes

Associe coordenadas para que o cartão apareça na tela de bloqueio perto de suas lojas ou estabelecimentos.

07

Datas, expiração e ciclo de vida

Defina datas de validade, estenda a expiração ao escanear e gerencie o ciclo de vida completo do cartão.

08

Análise e métricas

Monitore instalações, remoções, escaneamentos e resgates por cartão e coorte com exportações CSV e API.

Perguntas frequentes

Perguntas frequentes

É necessária uma conta de desenvolvedor Apple?

Não. O Passinstance disponibiliza certificados pré-configurados para emissão imediata.

Quais tipos de cartão são suportados?

Suporta cupons, ingressos, fidelidade, cartões de loja e cartões de membro.

TESTE PASSES DE PRODUÇÃO NO SEU TELEMÓVEL

Digitalize passes reais diretamente para Apple Wallet e Google Wallet

Aponte a câmara do seu smartphone para qualquer código QR abaixo para instalar instantaneamente um passe verificado. Experimente notificações no ecrã de bloqueio e integração nativa sem transferir apps.

Apple WalletGoogle WalletApple Wallet e Google Wallet
Private banking
Aurelia Private Bank - Private Client Cashback & Concierge
Experiência ao vivo

Teste o passe ao vivo da Aurelia Private Bank

Mostre o cashback em tempo real e o status do concierge 24 horas na agência ou no ponto de venda, sem outro app bancário.

ClienteAlexander Wright
Cashback€428.50
Conta•••• 9104
Abrir passe no telemóvel

Demonstrações interativas de passes para Apple Wallet e Google Wallet

Crie esta experiência Wallet no seu espaço de trabalho

Comece grátis mantendo o contexto desta demonstração para que o onboarding ofereça o modelo correspondente.

Desenvolva com a API Apple Wallet

Obtenha sua chave de API e emita seu primeiro cartão assinado para iPhone.