Skip to content
Desenvolvedores

API de cartões wallet

Uma API unificada para criar, atualizar e revogar cartões da Apple Wallet e Google Wallet com webhooks em tempo real.

  • API REST e webhooks
  • Apple Wallet + Google Wallet
  • Modelos, lote e sandbox
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

O Passinstance disponibiliza uma API para automatizar todo o ciclo de vida dos cartões: emissão a partir de modelos, alteração de saldos e dados, envio de alertas push e cancelamento.

Webhooks notificam seus servidores na instalação, alteração e escaneamento no PDV, mantendo sistemas sempre sincronizados.

Recursos

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

01

Endpoints para todo o ciclo de vida

Crie, consulte, atualize e revogue cartões e modelos com endpoints REST consistentes.

02

Webhooks em tempo real

Receba eventos de instalação, atualização e resgate sem consultas repetitivas.

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

Atualizações específicas da carteira

Atualize os dados pela API. A Apple Wallet pode exibir mensagens configuradas; o Google controla seus alertas integrados.

06

Relevância da localização

Configure locais para recursos compatíveis. Disponibilidade, exibição e permissões dependem da carteira e das configurações do cliente.

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.

Perguntas frequentes

Perguntas frequentes

O que a API de cartões wallet faz?

Crie, atualize e revogue cartões Apple Wallet e Google Wallet por API. A Apple Wallet usa APNs nas atualizações; o Google controla alertas integrados. A API também oferece modelos e webhooks de eventos.

É uma única API para iPhone e Android?

Sim. Uma única integração atende ambas as plataformas.

A API suporta webhooks?

Sim. Eventos de ciclo de vida são entregues instantaneamente aos seus servidores.

Existe ambiente sandbox?

Sim. Ambiente de testes e chaves de API disponíveis para desenvolvimento.

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 de cartões wallet

Comece gratuitamente, pegue suas chaves de API e automatize seus cartões com webhooks.