WalletWallet API
Voltar ao blog

Como criar uma conta no Apple Developer e gerar o certificado Pass Type ID (2026)

Inscreva-se no Apple Developer Program como pessoa física ou organização, veja quando o D-U-N-S é necessário e crie o Pass Type ID, o certificado que assina seus passes do Apple Wallet e a chave de push que os atualiza.

2026-10-02 Por Alen Todorov

Todo passe do Apple Wallet é assinado com um certificado Pass Type ID, e só um membro do Apple Developer Program pode criar esse certificado. Este guia cobre o caminho completo: inscrever sua empresa na Apple, registrar um Pass Type ID, criar o certificado e a chave de push, e adicionar os dois à WalletWallet para que seus passes levem a sua própria identidade.

Todos os passos e preços deste guia foram conferidos no processo de inscrição atual da Apple em outubro de 2026.

Reserve cerca de uma hora de trabalho prático. A espera é maior: uma organização sem número D-U-N-S pode precisar de uma semana ou mais até a Apple aceitar a inscrição.

O que você precisa antes de começar

Para qualquer inscrição:

  • Uma Conta Apple com autenticação de dois fatores ativada.
  • Seu nome e sobrenome como constam nos documentos nessa Conta Apple. A Apple atrasa inscrições que usam apelido, pseudônimo ou nome de empresa nos campos de nome.
  • US$ 99 por ano. Em alguns países, a Apple cobra o valor na moeda local.

Para uma empresa, associação ou escola, também:

  • Pessoa jurídica registrada. Use o nome registrado da organização: a Apple não aceita nomes fantasia, nomes comerciais nem filiais nessa inscrição.
  • Um número D-U-N-S dessa pessoa jurídica (órgãos públicos são isentos).
  • Poder para assinar pela organização: o dono ou fundador, um executivo, um líder sênior de projeto ou um funcionário a quem esse poder foi concedido.
  • Um e-mail de trabalho em um domínio associado à organização.
  • Um site público e funcionando em um domínio associado à organização. A Apple não aceita páginas de redes sociais, sites sem conteúdo suficiente nem páginas padrão de domínios estacionados.
Página de ajuda Inscrição nos programas da Apple, com os requisitos para organizações
A Apple lista o que confirma sobre uma organização antes de a inscrição começar.

Pessoa física ou organização

Pessoa física Organização
Quem Você, com seu nome legal Uma empresa, organização sem fins lucrativos ou escola registrada
Número D-U-N-S Não é necessário Obrigatório
Membros da equipe Só você Convide colegas com funções próprias
Isenção da taxa Não Disponível para organizações sem fins lucrativos, escolas e órgãos públicos que se qualificam

Se você atua como empresário individual, ou seu negócio não é reconhecido como pessoa jurídica no cadastro D-U-N-S, inscreva-se como pessoa física. Todos os demais devem se inscrever como organização, para que a conta pertença ao negócio e sobreviva a uma troca de equipe.

Se você tem várias marcas próprias, uma única conta de organização pode ter um Pass Type ID para cada uma. Uma plataforma ou agência que emite passes para empresas clientes pode guardar o certificado de cada cliente em um conjunto de credenciais (credential set) separado na WalletWallet, para que os passes de cada cliente levem a identidade dele.

Isenção da taxa para organizações sem fins lucrativos, escolas e órgãos públicos

Uma organização sem fins lucrativos reconhecida oficialmente no seu país, uma instituição de ensino credenciada ou um órgão público pode pedir à Apple a isenção da taxa anual. A organização não pode vender apps pagos, compras dentro do app nem outros bens digitais pela App Store. Uma associação, clube ou escola com esse status jurídico que só emite carteirinhas de sócio ou de estudante pode solicitar. Peça a isenção durante a inscrição da organização.

Requisitos de isenção da taxa do Apple Developer Program para organizações sem fins lucrativos, instituições de ensino e entidades governamentais
Os requisitos da isenção de taxa na ajuda de conta da Apple.

Passo 1: Obtenha ou encontre seu número D-U-N-S

Pule este passo se você se inscrever como pessoa física.

A Apple usa o número D-U-N-S da Dun & Bradstreet para verificar se sua organização existe como pessoa jurídica no endereço informado. Muitas empresas já têm um sem saber. Consulte o seu na ferramenta de consulta D-U-N-S da Apple, que pede a razão social, o endereço da sede, um endereço de correspondência e seus dados de contato profissionais.

Página de ajuda da Apple sobre o D-U-N-S explicando como consultar ou solicitar o número e quais dados são pedidos
A consulta pede o nome da entidade legal, o endereço da sede, o endereço de correspondência e o contato de trabalho.
A tela Sign in to Apple Developer que dá acesso à ferramenta de consulta D-U-N-S
A ferramenta de consulta D-U-N-S abre depois que você entra com sua Conta Apple.

Se não houver número, solicite um pela mesma ferramenta. Segundo a Apple, é gratuito na maioria dos países. A Dun & Bradstreet pode levar até 5 dias úteis para emiti-lo, e a Apple pode levar até mais 2 dias úteis para recebê-lo. Portanto, reserve até 7 dias úteis no total. Tenha em mãos os documentos de registro da empresa, porque um representante da D&B pode ligar para confirmar o tipo de negócio e o número de funcionários.

Página de ajuda D-U-N-S da Apple com os prazos: até 5 dias úteis da D&B e até mais 2 para a Apple
Até 5 dias úteis para a D&B emitir o número e até mais 2 para a Apple recebê-lo.

Se a consulta disser que sua organização “is not listed as a legal entity”, a D&B a registrou como outra coisa, geralmente como empresário individual. Ou você se inscreve como pessoa física, ou envia por e-mail à D&B seus documentos de registro e pede a atualização do cadastro.

Passo 2: Inscreva-se no Apple Developer Program

Há duas formas de entrar: pela web, disponível em qualquer lugar, e pelo app Apple Developer, nas regiões onde a Apple aceita a inscrição pelo app.

Pela web. Acesse developer.apple.com/programs/enroll, clique em Start your enrollment e entre com sua Conta Apple. Escolha o tipo de entidade (pessoa física ou organização), preencha os dados legais, aceite o Apple Developer Program License Agreement e pague.

Página de ajuda Inscrição nos programas da Apple, com a seção sobre como iniciar a inscrição
A ajuda de conta da Apple explica como iniciar a inscrição, pela web ou pelo app Apple Developer.

No app Apple Developer. Em um iPhone, iPad ou Mac com Apple Silicon, abra o app Apple Developer, entre na conta e toque em Enroll Now. O app verifica sua identidade, geralmente com um documento oficial com foto, e cobra a taxa como uma assinatura da App Store. Use o mesmo dispositivo do início ao fim. A assinatura é renovada todo ano até você cancelá-la.

O app Apple Developer na App Store
O app Apple Developer, gratuito na App Store, faz a inscrição com verificação de identidade.

Para uma organização, informe a razão social exatamente como aparece no cadastro D-U-N-S. Se os nomes não coincidirem, a Apple poderá pedir esclarecimentos, o que atrasa a inscrição.

A Apple envia um e-mail quando a assinatura estiver ativa. A partir daí, Certificates, Identifiers & Profiles fica disponível na sua conta.

Passo 3: Registre um Pass Type ID

Um Pass Type ID identifica um tipo de passe que você emite, por exemplo, seu cartão de fidelidade ou ingresso para um evento. Abra Identifiers e clique no botão de mais ao lado do título.

Certificates, Identifiers and Profiles na conta Apple Developer, com o botão de mais ao lado de Identifiers
O botão de mais ao lado de Identifiers inicia um novo registro.

Escolha Pass Type IDs na lista e clique em Continue.

A lista Register a new identifier com Pass Type IDs selecionado
Pass Type IDs fica na mesma lista que App IDs e Services IDs.

Informe uma descrição e um identificador no formato de domínio invertido, como pass.com.yourcompany.loyalty. O identificador não pode ser alterado depois, então use o seu próprio domínio. Clique em Continue e depois em Register.

O formulário de registro do Pass Type ID com uma descrição e um identificador em domínio invertido
O identificador começa com pass. seguido do seu domínio invertido.

Passo 4: Crie o certificado Pass Type ID

Abra Certificates e clique no botão de mais. Em Services (não em Software), escolha Pass Type ID Certificate, clique em Continue e selecione o Pass Type ID do passo 3. A Apple agora pede uma Certificate Signing Request.

A tela Create a New Certificate da Apple pedindo o envio de uma Certificate Signing Request
A Apple assina uma solicitação que você traz, e a chave privada por trás dela nunca vai para a Apple.

As instruções da própria Apple neste ponto usam o Acesso às Chaves (Keychain Access) em um Mac. Com a WalletWallet você dispensa o Keychain e o openssl:

  1. No painel da WalletWallet, abra Certificates e crie um conjunto de credenciais (por exemplo loyalty). Os conjuntos de credenciais estão incluídos no teste e em todos os planos pagos.
  2. Em Apple Wallet, clique em Generate signing request. A WalletWallet cria o par de chaves, guarda a chave privada criptografada do lado dela, e seu navegador baixa um arquivo .certSigningRequest.

De volta à aba da Apple, clique em Choose File, selecione esse arquivo e clique em Continue.

Envio do arquivo .certSigningRequest para o portal Apple Developer
Envie o arquivo .certSigningRequest gerado pela WalletWallet.

A Apple emite o certificado. Clique em Download para salvar o arquivo .cer.

A tela Download Your Certificate da Apple para o novo certificado Pass Type ID
O certificado é baixado como um arquivo .cer.

No conjunto de credenciais, em Upload your certificate, escolha o .cer e clique em Upload certificate. A WalletWallet lê o Pass Type ID e o seu Team ID do certificado, então não há nada para digitar, e mostra no conjunto a data de validade do certificado.

Passo 5: Crie a chave de push para atualizar os passes

Passes instalados só recebem atualizações (uma nova contagem de selos, um assento alterado, uma associação renovada) quando a atualização é enviada pelo Apple Push Notification service. Para isso é preciso uma chave de autenticação APNs. Sem ela, os passes continuam sendo instalados, mas a WalletWallet não consegue enviar alterações para os passes que já estão nos celulares.

Abra Keys e clique no botão de mais.

A lista Keys na conta Apple Developer
Keys fica na mesma barra lateral que Certificates e Identifiers.

Dê um nome à chave e marque Apple Push Notification service (APNs). Clique em Configure ao lado, escolha um ambiente que inclua Production (as atualizações do Wallet passam pelo APNs de produção) e escolha o tipo de chave Team Scoped, para que uma única chave sirva para todos os Pass Type IDs. Clique em Continue, revise a chave e clique em Confirm. A Apple limita quantas chaves APNs uma equipe pode ter, então reutilize esta em vez de criar uma por projeto.

Registro de uma nova chave com o Apple Push Notification service ativado
Ative o Apple Push Notification service (APNs) na nova chave.

Baixe o arquivo .p8. A Apple só permite baixá-lo uma vez, então guarde uma cópia em um lugar seguro.

Download da chave de autenticação APNs .p8 na conta Apple Developer
O arquivo .p8 só pode ser baixado uma vez.

A página da chave mostra o Key ID, um código de 10 caracteres.

A página de detalhes da chave na conta Apple Developer mostrando o Key ID
Copie o Key ID da página de detalhes da chave.

No conjunto de credenciais, em Add your push key, cole o Key ID, escolha o arquivo .p8 e clique em Add push key. Envie o certificado primeiro, porque a chave de push é vinculada ao Team ID lido dele.

Passo 6: Emita um passe com o seu certificado

O conjunto de credenciais agora guarda seu certificado e sua chave de push. No Pass Editor, escolha o conjunto antes de criar um passe. Pela API, envie o slug dele no campo credentials:

curl -X POST https://api.walletwallet.dev/api/passes \
  -H "Authorization: Bearer ww_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "credentials": "loyalty",
    "title": "Bayroast Coffee",
    "barcodeFormat": "QR",
    "barcodeValue": "MEMBER-4821",
    "primaryFields": [{ "label": "Member", "value": "Ada L." }],
    "secondaryFields": [{ "label": "Stamps", "value": "3 / 10" }]
  }'

O passe é assinado com o seu Pass Type ID e o seu Team ID, e as atualizações dele são enviadas com a sua chave. O formato completo da requisição está na documentação.

Manutenção

  • Renove a assinatura todo ano. Inscrições feitas pelo app são renovadas automaticamente como assinatura da App Store. As feitas pela web são renovadas na conta, e em algumas regiões dá para ativar a renovação automática.
  • Acompanhe a validade do certificado. Certificados Pass Type ID expiram. A data aparece no conjunto de credenciais, e renovar significa repetir o passo 4 com uma nova solicitação de assinatura gerada pela WalletWallet.
  • Garanta que o titular da conta (Account Holder) esteja disponível. Só o titular da conta pode aceitar contratos atualizados da Apple, e a Apple pode limitar o acesso à conta até que ele aceite. Sempre que possível, atribua essa responsabilidade a alguém com vínculo duradouro com a organização.

Motivos comuns para a Apple atrasar uma inscrição

  • Pseudônimo ou nome de empresa nos campos de nome e sobrenome da Conta Apple.
  • Razão social diferente da que consta no cadastro D-U-N-S.
  • Nome comercial, nome fantasia ou filial informado no lugar da pessoa jurídica.
  • Caixa postal como endereço.
  • Site provisório, página de rede social ou site em um domínio não associado à organização.

Google Wallet

O Google Wallet usa credenciais diferentes: uma conta de emissor no Google Pay & Wallet Console e uma chave de conta de serviço. O guia da conta de emissor do Google Wallet explica a configuração do Google Wallet. As credenciais das duas plataformas ficam no mesmo conjunto de credenciais.

Crie seu primeiro passe

Uma requisição JSON vira um passe que se instala no Apple Wallet e no Google Wallet, com atualizações ao vivo que chegam aos dois.