Patient Pass

Patient Pass ist das Produkt: eine digitale Karte in Apple Wallet oder Google Wallet, die belegt, wer die Person ist. Sie scannen den Barcode, rufen Verify auf und erhalten shop-bezogene Identitäts-Handles. Die API-Pfade heißen weiter /wallet-passes. Das ist der technische Name. Gegenüber Kunden und Ops heißt das Angebot Patient Pass.

Patient Pass ist nicht der OTP-Flow am Apotheken-Tablet. QR plus OTP gehört zum Apotheken-Tool und ist ein anderes Produkt. Diese Seite behandelt nur Ausstellung über die Management API und POST /wallet-passes/verify.

Was RxScale bereitstellt, was Sie tun

RxScale richtet Organisation, Shop, API-Schlüssel (patient:write, wallet_pass:write, wallet_pass:verify) und die Patient-Pass-Vorlage ein. Sie legen den Patienten in diesem Shop an, stellen den Pass aus, senden die Download-Links und verifizieren Scans. Sie gestalten den Pass nicht und erzeugen keine API-Schlüssel.

Ausstellung in zwei Schritten

Der Patient muss bereits Kunde des Shops sein (shop_customer_id an diesem Shop). Legen Sie ihn zuerst an oder lösen Sie ihn auf, dann stellen Sie den Pass aus.

curl -X POST "https://api.rxscale.com/v1/management/patients" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "shop_uid": "shop_123",
    "shop_customer_id": "kunden-123",
    "email": "max@example.com"
  }'

Danach:

curl -X POST "https://api.rxscale.com/v1/management/wallet-passes" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_pass_template_uid": "wpt-abc123",
    "shop_customer_id": "kunden-123",
    "shop_identifier": "mein-shop"
  }'

Ein Patient, der kein Kunde des gewählten Shops ist, wird abgelehnt. Überspringen Sie Schritt 1 nicht.

Reine Identitätsvorlagen vs. Rezeptvorlagen

Neue Vorlagen verlangen ein unterschriebenes Rezept, es sei denn, Ops markiert die Vorlage als reine Identitätsvorlage.

Rezeptvorlagen — Ausstellung nach unterschriebenem Rezept. SKU-zugeordnete Vorlagen werden automatisch ausgestellt, sobald das Rezept unterschrieben ist.
Reine Identitätsvorlagen — frühere Ausstellung, ohne Rezept auf der Karte. Das ist eine bewusste Opt-in-Einstellung an der Vorlage.

Was sind Wallet Passes?

Ein Wallet Pass ist die digitale Karte hinter Patient Pass. Er liegt in Apple Wallet oder Google Wallet und trägt einen Barcode, den Sie zur Identitätsprüfung scannen. Einsatz:

Patientenverifizierung — über Verify, nicht über OTP am Apotheken-Tablet.
Schnelle Identifikation — ein Scan ergibt patient_profile_uid und shop_customer_id.
Push-Benachrichtigungen — Updates über den Pass.

Wallet Passes erstellen

Sie können Wallet Passes für Ihre Patienten über die Management API erstellen. Wenn Sie einen Wallet Pass erstellen:

Das System generiert einen eindeutigen Wallet Pass für den Patienten.
Der Patient erhält einen Link, um den Pass auf sein Telefon hinzuzufügen.
Nach dem Hinzufügen wird der Pass in Apple Wallet oder Google Wallet gespeichert.

Patienten müssen den Pass aktiv auf ihr Telefon hinzufügen. Der Pass wird nicht automatisch installiert — sie erhalten einen Link und müssen darauf tippen, um ihn hinzuzufügen.

Der Inhalt des Passes kommt aus dem Wallet-Pass-Template. Wenn die Felder zugeordnet sind, übernimmt RxScale das Geburtsdatum und das Datum der ersten signierten oder nicht-QES-signierten Verschreibung (Patient seit), zusätzlich zu Name und letzter Verschreibung.

Wallet Passes über die API verwalten

Die Management API bietet vollständigen CRUD-Zugriff für Wallet Passes. Alle Endpoints erfordern einen API-Schlüssel mit den entsprechenden Berechtigungen (wallet_pass:read, wallet_pass:write).

Wallet Pass erstellen oder aktualisieren

Verwenden Sie den Create-Endpoint, um einen neuen Wallet Pass für einen Patienten auszustellen. Wenn bereits ein Wallet Pass für dieselbe Vorlage und denselben Patienten existiert, wird dieser aktualisiert, anstatt ein Duplikat zu erstellen.

curl -X POST "https://api.rxscale.com/v1/management/wallet-passes" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_pass_template_uid": "wpt-abc123",
    "shop_customer_id": "kunden-123",
    "shop_identifier": "mein-shop"
  }'

Antwort (201 Created für neue Passes, 200 OK für Aktualisierungen):

{
  "uid": "wp-abc123",
  "wallet_pass_template_uid": "wpt-abc123",
  "external_id": "ext-123",
  "serial_number": "SN-123",
  "ios_download_url": "https://...",
  "android_download_url": "https://...",
  "patient_profile_uid": "pp-abc123",
  "created_at": 1712000000
}

Die Antwort enthält Download-URLs für iOS und Android. Teilen Sie diese Links mit Ihrem Patienten, damit er den Pass auf sein Telefon hinzufügen kann.

Der Create-Endpoint verwendet Upsert-Semantik. Sie können ihn sicher mehrfach für denselben Patienten und dieselbe Vorlage aufrufen, ohne doppelte Passes zu erstellen.

Vorlagen, die Rezeptdaten anzeigen, werden ausgestellt, nachdem für den Patienten ein unterschriebenes Rezept vorliegt. Reine Identitätsvorlagen können früher ausgestellt werden. Im Admin-Tool unter Einstellungen → Wallet-Passes können Sie eine Vorlage so markieren, dass sie trotzdem auf ein unterschriebenes Rezept wartet, auch wenn sie keine Rezeptdaten anzeigt.

Wird die Ausstellung aus diesem Grund zurückgestellt, liefert der Create-Aufruf einen 400 mit einer konkreten Meldung statt eines allgemeinen Fehlers:

{
  "error": "The wallet pass template requires a signed prescription, but this patient has none."
}

Das ist ein wiederholbarer Zustand und kein Fehler Ihrer Anfrage. Rufen Sie den Endpoint erneut auf, sobald für den Patienten ein unterschriebenes Rezept vorliegt; die oben beschriebene Upsert-Semantik macht den erneuten Aufruf sicher. Bei Vorlagen, die einer SKU zugeordnet sind, wird der Pass automatisch ausgestellt, sobald das Rezept unterschrieben ist — ein erneuter Aufruf ist dann nicht nötig.

Wallet Pass abrufen

Details zu einem bestimmten Wallet Pass über seine UID abrufen:

curl -X GET "https://api.rxscale.com/v1/management/wallet-passes/{wallet_pass_uid}" \
  -H "X-API-Key: {api_key}"

Wallet Passes auflisten

Alle Wallet Passes für einen bestimmten Kunden auflisten:

curl -X GET "https://api.rxscale.com/v1/management/wallet-passes?shop_customer_id=kunden-123&shop_identifier=mein-shop" \
  -H "X-API-Key: {api_key}"

Optional können Sie mit dem Query-Parameter wallet_pass_template_uid nach Vorlage filtern.

Wallet Pass löschen

Einen Wallet Pass widerrufen, wenn er nicht mehr benötigt wird:

curl -X DELETE "https://api.rxscale.com/v1/management/wallet-passes/{wallet_pass_uid}" \
  -H "X-API-Key: {api_key}"

Gibt 204 No Content bei Erfolg zurück. Der Pass wird beim externen Wallet-Pass-Anbieter entfernt und ist auf dem Telefon des Patienten nicht mehr gültig.

Gescannten Pass verifizieren

Beim Scannen eines Patient Pass erhalten Sie dessen wallet_pass_uid. Senden Sie diese, um den Pass der dahinterstehenden Patientin oder dem Patienten zuzuordnen. Erfordert einen API-Schlüssel mit der Berechtigung wallet_pass:verify.

curl -X POST "https://api.rxscale.com/v1/management/wallet-passes/verify" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"wallet_pass_uid": "3f9a1c2e-7b04-4c11-9f3d-2a8e5b6c0d17"}'

{
  "valid": true,
  "status": "active",
  "wallet_pass_uid": "3f9a1c2e-7b04-4c11-9f3d-2a8e5b6c0d17",
  "patient_profile_uid": "b21d4f8a-5c33-4e90-8a72-1f6b9d0c4e55",
  "shop_customer_id": "cust-123"
}

Ein widerrufener Pass liefert "valid": false mit "status": "revoked", sodass Sie einen stornierten Pass von einem fremden unterscheiden können. Ein Pass einer anderen Organisation liefert 404, genau wie ein unbekannter Wert.

Behandeln Sie die wallet_pass_uid wie ein Zugangsgeheimnis — wer sie besitzt, kann die dahinterstehende Patientin oder den Patienten ermitteln. Senden Sie sie im Request-Body, niemals in einer URL, und schreiben Sie sie nicht in Logs.

Dieser Endpoint liefert ausschliesslich Identitäts-Handles. Die Details der Patientin oder des Patienten laden Sie über GET /v1/management/patients.

Vorlagen auflisten

Verfügbare Wallet-Pass-Vorlagen für einen Shop auflisten:

curl -X GET "https://api.rxscale.com/v1/management/wallet-passes/templates?shop_identifier=mein-shop" \
  -H "X-API-Key: {api_key}"

Push-Benachrichtigungen senden

Push-Benachrichtigungen über Wallet Passes an Patienten senden:

curl -X POST "https://api.rxscale.com/v1/management/wallet-passes/push-notifications" \
  -H "X-API-Key: {api_key}" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "wallet_pass_uid": "wp-abc123",
      "message": "Ihr Rezept wurde unterschrieben."
    }
  ]'

Wenn Sie einen Pass aktualisieren, werden die Änderungen automatisch auf das Telefon des Patienten übertragen. Der Patient muss nichts tun, um die aktualisierten Informationen zu sehen.

Automatische Aktualisierung bei Profiländerungen

Wenn das Profil eines Patienten aktualisiert wird (z.B. Namensänderung nach Heirat), werden alle bestehenden Wallet Passes dieses Patienten automatisch aktualisiert. Die neuen Daten werden an den Wallet-Pass-Anbieter übermittelt, sodass der Pass des Patienten immer aktuelle Informationen anzeigt.

Push-Benachrichtigungen

Eine der leistungsstärksten Funktionen von Wallet Passes ist die Möglichkeit, Push-Benachrichtigungen an Patienten zu senden. Wenn ein Patient Ihren Wallet Pass auf seinem Telefon hat, können Sie ihm Benachrichtigungen senden, die auf seinem Sperrbildschirm erscheinen. Häufige Einsatzzwecke für Push-Benachrichtigungen:

Patienten benachrichtigen, dass ihr Rezept unterschrieben wurde.
Patienten informieren, dass ihre Bestellung versandt wurde.
Patienten an bevorstehende Sprechstunden erinnern.

Push-Benachrichtigungen werden über die Wallet-Pass-Plattform gesendet, sodass Patienten sie auch dann erhalten, wenn sie Ihre App nicht aktiv nutzen.

Gescannten Patient Pass verifizieren

Der Barcode enthält wallet_pass_uid. Senden Sie ihn an Verify. Sie erhalten Identitäts-Handles, keine OTP-Aufforderung der Apotheke.

Patient zeigt den Pass

Der Patient öffnet Apple Wallet oder Google Wallet und zeigt den Barcode.

Sie scannen

Ihr Scanner liest wallet_pass_uid. Behandeln Sie den Wert wie ein Zugangsgeheimnis.

Verify aufrufen

POST /v1/management/wallet-passes/verify mit der UID im Body. Bei eigenem, aktivem Pass erhalten Sie patient_profile_uid und shop_customer_id.

Profildetails laden Sie danach mit GET /v1/management/patients. OTP am Apotheken-Tablet steht unter Tablet-Wallet-Pass und gehört nicht zu diesem SKU.

Telemedizin-Anbieter-Anleitung

Patient Pass

Patient Pass

Was RxScale bereitstellt, was Sie tun

Ausstellung in zwei Schritten

Reine Identitätsvorlagen vs. Rezeptvorlagen

Was sind Wallet Passes?

Wallet Passes erstellen

Wallet Passes über die API verwalten

Wallet Pass erstellen oder aktualisieren

Wallet Pass abrufen

Wallet Passes auflisten

Wallet Pass löschen

Gescannten Pass verifizieren

Vorlagen auflisten

Push-Benachrichtigungen senden

Automatische Aktualisierung bei Profiländerungen

Push-Benachrichtigungen

Gescannten Patient Pass verifizieren

Verwandte Themen

​Patient Pass

​Was RxScale bereitstellt, was Sie tun

​Ausstellung in zwei Schritten

​Reine Identitätsvorlagen vs. Rezeptvorlagen

​Was sind Wallet Passes?

​Wallet Passes erstellen

​Wallet Passes über die API verwalten

​Wallet Pass erstellen oder aktualisieren

​Wallet Pass abrufen

​Wallet Passes auflisten

​Wallet Pass löschen

​Gescannten Pass verifizieren

​Vorlagen auflisten

​Push-Benachrichtigungen senden

​Automatische Aktualisierung bei Profiländerungen

​Push-Benachrichtigungen

​Gescannten Patient Pass verifizieren

​Verwandte Themen

Patient Pass

Was RxScale bereitstellt, was Sie tun

Ausstellung in zwei Schritten

Reine Identitätsvorlagen vs. Rezeptvorlagen

Was sind Wallet Passes?

Wallet Passes erstellen

Wallet Passes über die API verwalten

Wallet Pass erstellen oder aktualisieren

Wallet Pass abrufen

Wallet Passes auflisten

Wallet Pass löschen

Gescannten Pass verifizieren

Vorlagen auflisten

Push-Benachrichtigungen senden

Automatische Aktualisierung bei Profiländerungen

Push-Benachrichtigungen

Gescannten Patient Pass verifizieren

Verwandte Themen