Skip to content
Développeurs

API de cartes wallet

Une API unique pour créer, mettre à jour et révoquer des cartes Apple Wallet et Google Wallet, avec webhooks en temps réel.

  • API REST et webhooks
  • Apple Wallet + Google Wallet
  • Modèles, batch et environnement bac à sable
Fonctionne avec:
Apple WalletApple WalletGoogle WalletGoogle Wallet

Explorateur de l'API REST Passinstance

Exemple illustratif

Exemples de requêtes et de réponses. Aucun appel API n'est envoyé.

POST/api/v1/passes
Émettez une carte personnalisée pour Apple Wallet et Google Wallet avec ses liens de téléchargement.
curl -X POST https://api.passinstance.com/api/v1/passes \
  -H "X-API-Key: $PASSINSTANCE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "customFields": {
      "customerName": { "label": "MEMBER", "value": "Jane Doe" },
      "pointsBalance": { "label": "POINTS", "value": "1,450 pts" },
      "tier": { "label": "TIER", "value": "Gold VIP" }
    },
    "barcodeMessage": "PASS-MEM-2026-8819"
  }'
Réponse d'exemple
201 Created
{
  "ok": true,
  "data": {
    "id": "pass_9842011a",
    "templateId": "tpl_gold_vip_001",
    "serialNumber": "MEM-2026-8819",
    "status": "active",
    "downloadUrl": "https://api.passinstance.com/api/v1/passes/pass_9842011a/download",
    "googleWalletUrl": "https://pay.google.com/gp/v/save/eyJhbGciOiJSUzI1...",
    "applePassUrl": "https://passinstance.com/p/pass_9842011a.pkpass",
    "createdAt": "2026-08-16T15:25:00Z"
  }
}
Vue d'ensemble

Passinstance met à disposition une API de cartes wallet permettant d'automatiser tout le cycle de vie : création à partir de modèles, mise à jour des champs et codes-barres, notifications push et révocation pour Apple Wallet et Google Wallet via une seule intégration.

Les webhooks informent vos serveurs lors des installations, mises à jour et utilisations, permettant une synchronisation parfaite avec votre CRM, ERP ou système de caisse sans requêtes répétitives.

Capacités

Ce que vous déployez en production

01

Endpoints pour tout le cycle de vie

Créez, lisez, mettez à jour et révoquez cartes et modèles via des endpoints REST prévisibles et idempotents.

02

Webhooks en temps réel

Recevez les événements d'installation, mise à jour et validation pour synchroniser vos systèmes en direct.

03

API de cartes wallet

Créez, mettez à jour et révoquez des cartes par programmation grâce à l'API REST et aux webhooks en temps réel.

04

Codes QR et liens de téléchargement

Distribuez vos cartes par pages d'ajout hébergées, QR codes, email, SMS ou en caisse — installation en un clic, sans application.

05

Mises à jour propres à chaque wallet

Mettez à jour les données par API. Apple Wallet peut afficher des messages configurés ; Google contrôle ses alertes intégrées.

06

Pertinence géographique

Configurez des lieux pour les fonctions prises en charge. Disponibilité, affichage et autorisations dépendent du wallet et des réglages du client.

07

Dates, expiration et cycle de vie

Définissez dates de validité et expiration, prolongez lors du scan et pilotez le cycle de vie complet de chaque carte.

FAQ

Questions avant d'émettre

Que permet de faire l'API de cartes wallet ?

Créez, mettez à jour et révoquez des cartes Apple Wallet et Google Wallet par API. Apple Wallet utilise APNs pour les mises à jour ; Google contrôle ses alertes intégrées. L’API propose aussi des modèles et des webhooks d’événements.

Existe-t-il une seule API pour iPhone et Android ?

Oui. Une intégration unique génère les cartes pour Apple Wallet (.pkpass) et Google Wallet (JWT) sans développement séparé.

L'API prend-elle en charge les webhooks ?

Oui. Les événements d'installation, de mise à jour et de scan en caisse sont envoyés en temps réel à vos serveurs.

Y a-t-il un environnement de test (sandbox) ?

Oui. Vous disposez d'un bac à sable et de clés API de test pour valider vos flux avant le passage en production.

TESTEZ DES PASS DE PRODUCTION SUR VOTRE SMARTPHONE

Scannez de vrais pass directement dans Apple Wallet & Google Wallet

Pointez l'appareil photo de votre smartphone vers un code QR ci-dessous pour installer instantanément un pass de production vérifié. Profitez des notifications sur écran verrouillé, du code-barres dynamique et de l'intégration native sans télécharger d'application.

Apple WalletGoogle WalletApple Wallet & Google Wallet
Banque privée
Aurelia Private Bank - Private Client Cashback & Concierge
Expérience en direct

Tester le pass en direct d’Aurelia Private Bank

Présentez votre cashback en temps réel et l’accès au service de conciergerie 24 h/24 en agence ou en point de vente, sans application bancaire dédiée.

ClientAlexander Wright
Cashback428,50 €
Compte•••• 9104
Ouvrir le pass sur mobile

Démonstrations interactives de pass pour Apple Wallet et Google Wallet

Créez cette expérience Wallet dans votre espace

Commencez gratuitement en conservant le contexte de cette démo afin que l'onboarding vous propose le modèle correspondant.

Développez avec l'API de cartes wallet

Démarrez gratuitement, obtenez vos clés d'API et automatisez l'émission de cartes Apple Wallet et Google Wallet.