Emite y actualiza pases Wallet desde tu propio sistema.
Firmar pases de Apple, gestionar objetos de Google y mantener cada cambio sincronizado es un proyecto en sí mismo. La API de Vuelvy permite a tu equipo técnico integrar altas, emisión, actualizaciones, eventos y canjes de un programa ya publicado. El diseño y la publicación del programa se hacen en el panel.
Google comparte tu nombre, email y foto de perfil, si está disponible, para verificar tu identidad. Esto no te suscribe a publicidad. Política de privacidad
La disponibilidad de avisos y actualizaciones depende de las capacidades y políticas de cada Wallet.
- 01Claves con permisos por operación
- 02Idempotency-Key donde se exige
- 03Emisión asíncrona consultable
- 04Documentación según el alcance
Qué puedes integrar
La API Wallet v1 cubre la operación diaria de un programa publicado. El diseño del pase y la publicación de versiones siguen en el panel de Vuelvy y no se administran por API.
- Altas, perfiles y consentimientos
- Emisión, consulta y actualización de pases
- QR y enlaces de alta
- Eventos, puntos, beneficios y canjes
Un ejemplo mínimo del contrato
Para emitir un pase, tu sistema envía una petición autenticada con su clave y una clave de idempotencia. La emisión es asíncrona: la respuesta confirma que la operación se ha aceptado, no que el cliente ya tenga el pase en su Wallet.
- Petición: POST /api/wallet/v1/passes con Authorization: Bearer y la cabecera Idempotency-Key.
- Cuerpo: programId del programa publicado, subscriberId opcional y datos del pase.
- Respuesta 202: passId, state «pending» e identificadores de operación para consultar su estado.
- Repetir la misma petición con la misma clave de idempotencia devuelve 200 sin crear otro pase.
Errores explícitos y reintentos seguros
Cada respuesta indica si debes corregir la petición, revisar permisos o reintentar. Las operaciones que lo exigen, como la emisión de pases, requieren Idempotency-Key: así, un reintento tras un corte de red no duplica la operación.
- 401 invalid_credentials: clave ausente, revocada o caducada
- 403 forbidden: la clave no tiene ese permiso
- 400 idempotency_key_required: falta la cabecera en una operación que la exige
- Límite de peticiones por clave
Apple y Google: un contrato común sin falsa paridad
La API unifica la lógica de negocio y Vuelvy genera la variante de cada proveedor. Apple y Google conservan credenciales, campos, actualizaciones y avisos distintos; cuando una capacidad no existe en una plataforma, no se simula.
Cómo se obtiene acceso y documentación
La referencia técnica no es pública. Si tu caso necesita integración, solicita una evaluación de alcance: revisamos qué operaciones necesitas, quién se responsabiliza de la integración y qué datos se intercambian. Después se crean claves con los permisos mínimos para tu organización y compartimos la documentación de esos endpoints. Cada caso se analiza de forma individual antes de contratar.
- Caso de uso y operaciones necesarias
- Permisos mínimos por clave
- Datos personales y consentimiento revisados
- Plan de pruebas antes de operar con clientes reales
FAQ
Preguntas frecuentes
¿La documentación de la API es pública?
No. La referencia de los endpoints se comparte cuando se acuerda el alcance técnico, junto con claves con los permisos mínimos para tu organización.
¿Puedo emitir para varias marcas?
Sí, con credenciales separadas: cada clave pertenece a una organización y solo opera sus programas, pases y datos. Una agencia con varias marcas usa claves distintas para cada organización.
¿Qué permite automatizar la API de Wallet Marketing?
La API permite conectar altas, emisión de pases, actualizaciones, estados y eventos del negocio con Apple Wallet y Google Wallet. El alcance se define por caso de uso para exponer solo las operaciones necesarias.
¿Una sola integración sirve para Apple Wallet y Google Wallet?
Vuelvy unifica la lógica de negocio y adapta la salida a cada proveedor, pero Apple y Google conservan modelos, credenciales y capacidades diferentes. La integración evita duplicar la operativa común sin fingir que ambas plataformas son idénticas.
¿Cómo se protege el acceso a la API y a los datos?
El acceso se autentica, se limita por organización y se registra para facilitar trazabilidad. Las credenciales de los proveedores y los datos de cada marca se mantienen separados según el alcance contratado.
¿La API envía webhooks a mi sistema?
La integración está pensada para que tu sistema envíe eventos y consulte el estado de las operaciones. Si tu caso necesita que Vuelvy notifique a otro sistema, se valora en la evaluación de alcance antes de comprometerlo. Las operaciones que lo exigen usan Idempotency-Key para que un reintento no duplique la operación.
Hablemos de tu caso
¿Tiene sentido Wallet para tu negocio?
Cuéntanos tu caso y te contactaremos por email para valorar integraciones, plan de activación y siguiente paso. Sin presentación genérica ni compromiso.
Google comparte tu nombre, email y foto de perfil, si está disponible, para verificar tu identidad. Esto no te suscribe a publicidad. Política de privacidad