Guía paso a paso para emitir tus tarjetas en Apple Wallet con tu propia cuenta de Apple. Solo necesitas crear una clave de API y subirla al panel: del certificado se encarga Omniwallet.
Para que un iPhone acepte tus tarjetas, Apple exige que los pases estén firmados con un certificado a nombre de tu empresa. En Omniwallet, este proceso está completamente automatizado: solo necesitas proporcionarnos una clave de API de tu cuenta de Apple y nosotros nos encargamos de generar, gestionar y renovar el certificado.
Requisitos previos
- Tener una cuenta activa en el Apple Developer Program (99 USD/año).
- Tener acceso a App Store Connect con el rol de Titular de la cuenta (Account Holder) o Admin.
Paso 1 — Activa tu cuenta en el Apple Developer Program
Apple solo emite certificados de Wallet a empresas inscritas en su programa. Si ya estás inscrito, sáltate al Paso 2.
- Entra en developer.apple.com/programs y haz clic en Enroll.
- Inicia sesión. Es preferible utilizar un Apple ID corporativo en lugar de la cuenta personal de un empleado.
- Selecciona el tipo de cuenta: Organización (necesitarás proporcionar tu número D-U-N-S) o Individual.
- Acepta los términos y condiciones, y paga la cuota anual.
Paso 2 — Crea la clave de API en App Store Connect
Esta clave es el puente que permite a Omniwallet conectarse de forma segura con tu cuenta de Apple.
- Accede a appstoreconnect.apple.com y entra en Usuarios y acceso (Users and Access).
- Ve a la pestaña Integraciones (Integrations) > API de App Store Connect y busca la sección Claves del equipo (Team Keys).
- Haz clic en el botón +. Asígnale un nombre fácil de identificar (por ejemplo, "Omniwallet") y, en el nivel de acceso (Access), selecciona Administración (Admin).
- Haz clic en Generar (Generate)
① La pestaña «Claves del equipo». ② El botón + para crear la clave.
① El nombre de la clave. ② El nivel de acceso: debe ser «Administración».
Paso 3 — Descarga el archivo y copia los identificadores
Al pulsar Generar, Apple vuelve a la lista de claves y la recién creada aparece en la tabla. En su fila verás el enlace Descargar (Download API Key), que solo aparece mientras no salgas de esa pantalla: en cuanto la abandones, el enlace desaparece y el archivo ya no se podrá recuperar.
Antes de salir de App Store Connect, necesitas extraer tres datos de esta pantalla:
- Archivo .p8: haz clic en Descargar (Download API Key) en la fila de la clave que acabas de crear. El archivo se llamará algo parecido a
AuthKey_Z89VYRWXX3.p8. - Id de la clave (Key ID): son los 10 caracteres (letras mayúsculas y números) que aparecen en la columna ID de clave de esa misma fila (ej:
Z89VYRWXX3). - Id del emisor (Issuer ID): lo encontrarás en la parte superior de la página, justo encima de la tabla de claves. Es una cadena larga separada por guiones (ej:
87ff0df3-749c-4b69-b646-30204a805397) y es el mismo para todas tus claves.
① El Id del emisor. ② La columna con el Id de la clave. ③ El acceso, que debe indicar «Administración».
Paso 4 — Configura los datos en Omniwallet
- Entra a tu panel de administrador en Omniwallet y ve a Programa > Tarjeta.
- Abre la pestaña Certificados y localiza el bloque llamado Certificado Apple Wallet.
- Pega el Id del emisor, pega el Id de la clave y sube el archivo
.p8que descargaste en el paso anterior. - Haz clic en Guardar.
Bloque «Certificado Apple Wallet» en Tarjeta → Certificados.
Paso 5 — Verifica la instalación
Si el proceso ha sido exitoso, el bloque mostrará un aviso verde "Certificado configurado" con la fecha de emisión, y verás un nuevo identificador en tu cuenta de Apple con el formato Omniwallet [tu-comercio] Storecard.
Aviso verde «Certificado configurado» con la fecha de emisión.
Para comprobar que todo funciona, envíate una tarjeta de prueba desde el panel de Omniwallet e intenta añadirla a un iPhone. Si se guarda sin errores, la configuración es correcta.
¿Tengo que renovar el certificado todos los años?
No. Aunque los certificados de Apple caducan anualmente, Omniwallet se encarga de renovarlos de forma automática 30 días antes de su fecha de vencimiento. Esto se hace sin cortes de servicio y sin que tengas que reemitir las tarjetas de tus clientes.
Para que esta renovación automática funcione, solo necesitas asegurarte de dos cosas: mantener al día el pago anual de tu Apple Developer Program y no revocar la clave de API en App Store Connect.