Apple Wallet
Cómo una credencial se vuelve un pase firmado, cómo se actualiza y qué cambia con tu propio certificado.
Un pase de Apple Wallet es un archivo: un .pkpass firmado que el dispositivo descarga y luego guarda. Una vez en el teléfono, el teléfono tiene una copia, y actualizarla es avisarle al dispositivo que vuelva por una nueva.
Nomi opera todo eso — la firma, el registro de dispositivos que Apple exige y el aviso que le dice a un dispositivo que su pase cambió. Del lado del API, tú pides el canal y miras su estado.
El canal de Apple de una credencial
{
"channel": "apple_wallet",
"state": "installed",
"installUrl": null,
"revision": 3,
"lastPushedAt": "2026-09-20T15:11:02Z"
}installUrl viene en nulo para Apple a propósito: Google entrega un enlace firmado y Apple entrega un archivo. El archivo se obtiene de GET /v1/credentials/{id}/channels/apple_wallet/artifact, y el enlace que recibe la persona sale de una distribución, que es lo que debe llevar un QR o un correo.
Estados del canal
| Estado | Significa |
|---|---|
pending | En cola para renderizarse. El estado normal justo después de emitir. |
provisioned | El pase existe y se puede entregar. |
installed | Un dispositivo se registró para recibir cambios: alguien lo agregó. |
stale | La credencial cambió; va en camino una versión nueva. |
failed | El render o la firma no salieron. Arregla la causa y vuelve a aprovisionar. |
removed | Quien lo llevaba borró el pase de su cartera. |
POST/v1/credentials/{id}/channels/{channel}/reprovision
Pone la credencial en cola para volver a renderizarse — tras subir material de firma, o tras un fallo.
Tu propio certificado
Los pases se pueden firmar con el certificado de tipo de pase de tu propia organización, de modo que la credencial se emite bajo tu identidad y no bajo la de Nomi. El material se sube en la consola, en la sección de firma, y ninguna llamada del API cambia.