Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.rxscale.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Wallet Passes

Wallet Passes sind digitale Karten, die Patienten auf ihrem Telefon zur Identitätsüberprüfung mit sich führen. Diese Seite erklärt, wie Telemedizin-Anbieter Wallet Passes in ihren Workflow integrieren können.

​
Was sind Wallet Passes?

Ein Wallet Pass ist eine digitale Karte, die in der Apple Wallet oder Google Wallet App des Patienten gespeichert wird. Er enthält einen QR-Code, der zur Überprüfung der Identität des Patienten gescannt werden kann. Stellen Sie ihn sich als eine digitale Mitgliedskarte vor, die immer auf dem Telefon des Patienten verfügbar ist. Wallet Passes sind nützlich für:
  • Patientenverifizierung — Bestätigung der Identität eines Patienten in einer Apotheke oder während einer Sprechstunde.
  • Schnelle Identifikation — Ermöglicht Mitarbeitern, die Informationen eines Patienten durch Scannen des QR-Codes abzurufen.
  • Push-Benachrichtigungen — Senden von Updates direkt über den Wallet Pass an Patienten.

​
Wallet Passes erstellen

Sie können Wallet Passes für Ihre Patienten über die Management API erstellen. Wenn Sie einen Wallet Pass erstellen:
  1. Das System generiert einen eindeutigen Wallet Pass für den Patienten.
  2. Der Patient erhält einen Link, um den Pass auf sein Telefon hinzuzufügen.
  3. 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.

​
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.

​
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.

​
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.

​
Patientenverifizierung per QR-Code

Der QR-Code auf einem Wallet Pass ermöglicht einen sicheren Identitätsüberprüfungsprozess:
1

Patient zeigt seinen Wallet Pass

Der Patient öffnet seine Wallet-App und zeigt den QR-Code auf seinem Pass.
2

Mitarbeiter scannt den QR-Code

Ein Apothekenmitarbeiter oder eine andere autorisierte Person scannt den QR-Code mit dem RxScale-System.
3

OTP-Verifizierung

Das System sendet ein Einmalpasswort (OTP) per SMS an die registrierte Telefonnummer des Patienten.
4

Identität bestätigt

Der Patient gibt dem Mitarbeiter das OTP. Nach der Überprüfung ist die Identität des Patienten bestätigt.
Diese zweistufige Verifizierung (QR-Code plus OTP) stellt sicher, dass nur der tatsächliche Patient die Verifizierung abschließen kann, selbst wenn jemand anderes eine Kopie des QR-Codes hat.

​
Verwandte Themen