Skip to content
Guía del Centro de ayuda · Certificados y credencialesFase de incorporación 3
3 min de lecturaVerificado 2026-11-16

Certificados de Apple Wallet

Crea un Pass Type ID en Apple Developer, genera el CSR, sube .cer/.p12 y vincula tu certificado.

En esta guía

Recorridos visuales interactivos

Abrir en la guía de 6 fases

Inspecciona las pantallas reales del panel y las anotaciones ampliadas de esta guía.

Enfoque de interfaz ampliado
Elementos clave de la interfaz

Template Settings — Firma e IDs externos (Ampliado)

Revisa estado del certificado, orden en Wallet, estado Published y unicidad de External IDs.

Descripción general: por qué son obligatorios los certificados Apple Pass Type ID

Apple exige que todo archivo .pkpass de producción esté firmado criptográficamente mediante un Certificado Pass Type ID emitido bajo la cuenta de Apple Developer Program de su organización (Certificate Management API en /api/v1/certificates). El certificado cumple dos funciones esenciales:

  1. 1
    Firma PKCS#7 independiente del paquete: Firma manifest.json dentro de cada archivo .pkpass (encadenando con el certificado intermedio WWDR G4/G6 de Apple) para que iOS verifique la autenticidad y muestre el nombre verificado de su organización.
  2. 2
    Autenticación push HTTP/2 de APNs: Autentica las conexiones TLS HTTP/2 hacia api.push.apple.com bajo el tópico pass.com.<domain>.<name> del certificado para que Passinstance pueda despertar los iPhone de sus clientes ante actualizaciones en vivo.
FLUJO DE ARQUITECTURA
ARQUITECTURA INTERACTIVA
APROVISIONAMIENTO DE CERTIFICADO APPLE PASS TYPE
ETAPA 01 PASO 1: Generar clave privada y CSR en Passinstance (Certificate Management API)
POST/api/v1/certificates/generate-csr
Genera CertificatePkey RSA de 2048 bits (cifrada en encrypted storage)
Devuelve solicitud .certSigningRequest (CSR) codificada en PEM
ETAPA 02 PASO 2: Apple Developer Portal (developer.apple.com)
1
Registrar IdentifierPass Type ID (pass.com.yourbrand.loyalty)
2
Create CertificateSubir CSR de PassinstanceDescargar pass.cer
ETAPA 03 PASO 3: Subir .cer firmado a Passinstance (POST/api/v1/certificates)
1
Analiza X.509 .cer: Extrae passTypeIdentifier, teamIdentifier y validez
2
Empareja el módulo de clave pública con el CertificatePkey guardado
3
Valida la cadena de confianza contra Apple WWDR G4 / G6
4
Empaqueta PKCS#12 (.p12) cifrado en encrypted storageEstado: VALID / ACTIVE

Requisitos previos: Necesita una suscripción activa al Apple Developer Program (rol Account Holder o Admin) para registrar Pass Type IDs y emitir certificados Pass Type ID de producción. Aunque Passinstance facilita un certificado sandbox administrado para las demostraciones iniciales de incorporación, debe vincular su propio certificado Pass Type ID antes de distribuir pases en producción a clientes: Apple no permite migrar pases ya instalados a un passTypeIdentifier o teamIdentifier diferente después de su instalación.

Flujo paso a paso para configurar el certificado

  1. 1
    Generar una CSR en Passinstance: Vaya a Configuración -> Wallet -> Certificados de Apple (/settings/workspace/wallet) y haga clic en Generar CSR (invoca POST /api/v1/certificates/generate-csr con passTypeId opcional). Descargue el archivo .certSigningRequest. Passinstance guarda la clave privada RSA generada (CertificatePkey) en almacenamiento cifrado.
  2. 2
    Registrar un Pass Type ID en Apple Developer: Inicie sesión en Apple Developer Portal -> Certificates, Identifiers & Profiles -> Identifiers, haga clic en +, elija Pass Type IDs y registre un identificador DNS inverso como pass.com.yourbrand.loyalty.
  3. 3
    Emitir el archivo .cer firmado en Apple Developer: Abra su nuevo Pass Type ID, haga clic en Create Certificate, suba el archivo .certSigningRequest descargado desde Passinstance y descargue el archivo resultante pass.cer.
  4. 4
    Subir pass.cer a Passinstance: Suba pass.cer mediante POST /api/v1/certificates (multipart/form-data, con teamIdentifier, passTypeId, demo, isNfcCertificate opcionales) o POST /api/v1/certificates/upsert (file + type: "TYPE_PASS" | "TYPE_NFC"). Passinstance enlaza el .cer con la clave privada generada, verifica la cadena intermedia Apple WWDR G4/G6 y empaqueta el contenedor cifrado .p12.
  5. 5
    Vincular el certificado a su plantilla: Abra Configuración de la plantilla y seleccione su certificado Pass Type ID verificado.

Referencia de la API de gestión de certificados (Certificate Management API)

MétodoRuta del endpointPermiso requeridoDescripción
POST/api/v1/certificates/generate-csrcertificates:manageGenera un par de claves RSA (CertificatePkey) y devuelve un Certificate Signing Request (.csr) en PEM.
POST/api/v1/certificatescertificates:manageSube un archivo .cer firmado por Apple vía multipart/form-data, verifica la confianza WWDR G4/G6 y activa el certificado (CertificateType: `TYPE_PASS \TYPE_NFC`).
POST/api/v1/certificates/upsertcertificates:manageCrea o actualiza/renueva un certificado existente desde un .cer firmado (multipart/form-data, opcionalmente pkeyId, type, intermediatePem).
GET/api/v1/certificatescertificates:readLista los certificados del espacio de trabajo con passTypeIdentifier, teamIdentifier, validFrom, validTo y estado.
GET/api/v1/certificates/:idcertificates:readDevuelve metadatos X.509 y detalles para un ID de certificado específico.
DELETE/api/v1/certificates/:idcertificates:manageElimina un certificado caducado o sin uso.

Ejemplo: generar una CSR y subir pass.cer

1. Generar CSR (POST /api/v1/certificates/generate-csr):

JSON
POST /api/v1/certificates/generate-csr
{
  "passTypeId": "pass.com.phenixroasters.loyalty"
}

Respuesta (200 OK):

JSON
{
  "success": true,
  "data": {
    "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICvDCCAaQCAQAwdzELMAkGA1UEBhMCREUx...\n-----END CERTIFICATE REQUEST-----"
  },
  "description": "CSR generated successfully",
  "errors": [],
  "statusCode": 200
}

2. Subir .cer firmado (POST /api/v1/certificates):

Envíe como multipart/form-data con el campo file (pass.cer), y opcionalmente passTypeId, teamIdentifier e isNfcCertificate ("false" o "true"):

BASH
curl -X POST https://api.passinstance.com/api/v1/certificates \
  -H "X-API-Key: <API_KEY>" \
  -F "file=@./pass.cer" \
  -F "passTypeId=pass.com.phenixroasters.loyalty" \
  -F "isNfcCertificate=false"

Respuesta (201 Created):

JSON
{
  "id": "cert_8841a9b0-2c3d-4e5f-8a9b-0c1d2e3f4a5b",
  "passTypeIdentifier": "pass.com.phenixroasters.loyalty",
  "teamIdentifier": "9A8B7C6D5E",
  "type": "TYPE_PASS",
  "validFrom": "2026-11-15T10:18:00.000Z",
  "validTo": "2027-12-15T10:17:59.000Z"
}

Consulte Renovación y gestión de certificados y Apple Wallet para el mantenimiento durante su ciclo de vida.

¿Listo para lanzar su primer programa de tarjetas Wallet?

Cree su espacio de trabajo, configure su plantilla y pruebe una tarjeta real en Apple Wallet y Google Wallet antes de escalar.