Hilfe Zentrum

Hier im Kortpress Hilfe Zentrum finden Sie Antworten zu häufig gestellten Fragen. Falls Ihr Thema nicht dabei ist oder Sie uns Feedback geben möchten, freuen wir uns auf ihre Nachricht!

Schön, dass Sie hier sind. Wie können wir Ihnen helfen?

Wählen Sie eine Kategorie aus, zu der Sie Hilfe benötigen.

Allgemein

Fragen und Antworten zu Preisen, Abrechnungen, Pass Updates uvm.

iOS Zertifikate

Tutorial zur Erstellung von iOS Credentials

Google Zertifikate

Tutorial zur Erstellung von Google Credentials

APNS

Erstellung von Apple Push Notification Service Credentials

Dokumentation

Alle Informationen zur Dokumentation für Entwickler:innen

Vereine

Interessant für nichtkommerzielle Vereine und Organisationen

Was ist eine UUID?

Ein UUID (Universally Unique Identifier) ist eine 128-Bit-Zahl, die zur Identifikation von Informationen in Computersystemen verwendet wird. Ein Synonym dafür ist auch der Ausdruck GUID (Globally Unique Identifier).

Benötige ich eine Mitgliedschaft im Apple Developer Program?

Um Passes erzeugen und signieren zu können, brauchen Sie eine Mitgliedschaft beim Apple Developer Program. Dort wird ein Zertifikat für Sie erstellt, das in Ihrem Account bei Kortpress hinterlegt wird und mit dem Sie die Passes signieren. Weitere Informationen zum Thema Apple Developer Program finden Sie unter: https://developer.apple.com/programs/

Was sind Apple Credentials und wozu werden sie verwendet?

Um auf der Kortpress Webanwendung Passes und Cards für iOS erstellen zu können, benötigen Sie zunächst verschiedene Dateien. Unter anderem auch die sogenannten Credentials, die aus Team Identifier, Pass Type Identifier, Pass Zertifikat und dem zugehörigen Passwort besteht. Diese Dateien erhalten Sie als Mitglied des Apple Developer Programs für iOS. Weitere Information zum Thema Apple Developer Program und Kortpress finden Sie unter: https://letsdev.de/blog/apple-developer-program

Wie kann ein Pass auf ein Smartphone geladen werden?

Kortpress bietet eine Landingpage mit den Download-Links und gleichzeitig einem QR-Code. Damit kann ein Pass komfortabel auf dem Smartphone installiert werden. Weiterhin können auch die einzelnen URLs geliefert werden, über die der Pass auf das Gerät geladen werden kann. Diese URLs können Sie per E-Mail, SMS, iMessage oder andere Dienste an Ihre Zielgruppen übermitteln.

Welche Grafiken benötige ich für die Erstellung eines Passes?

Für die jeweiligen Passes werden unterschiedliche Fotos, Grafiken und Logos benötigt. Sie finden Angaben zum Format beim Upload auf der Kortpress Webanwendung. Bitte beachten Sie, dass Ihre Medien in einem PNG-Format erstellt und hochgeladen werden müssen. Ihr Logo sollte dabei transparent (ohne Hintergrund) und in ausreichend hoher Qualität zur Verfügung stehen. Sollten Sie Hilfe bei der Erstellung benötigen, melden Sie sich bei uns! Unser Support unterstützt Sie gerne.

Wie funktionieren Push-Notifications bei den Apple Passes?

Push-Notifications sind ideale Kundenbindungswerkzeuge, um gezielt auf ein Angebot oder wichtige Hinweise aufmerksam zu machen. Aus technischen Restriktionen ist jedoch eine Push-Notifications immer mit einem Pass-Update verbunden. Nutzer:innen haben zudem die Möglichkeit, diese Hinweise zu deaktivieren. Google selbst unterstützt bisher keine Push-Notifications.

Wie kann eine Benachrichtigung zu einer bestimmten Lokation ausgegeben werden?

Benachrichtigungen können in der Kortpress Webanwendung im Bereich "Sperrbildschirm" definiert werden. Durch eine Adresse mit einer definierten Umkreisangabe kann eine Benachrichtigung auf dem Gerät der Nutzer:innen angezeigt werden. Der dementsprechende Pass kann dann direkt über den Sperrbildschirm geöffnet werden.

Wie kann ich mich in der Kortpress.io App einloggen und wie wird der zugehörige Voucher erstellt?

Laden Sie sich zunächst die Kortpress.io App herunter. Die App gibt es kostenlos im App Store für iOS und bei Google Play für Android. Um sich in der App anzumelden, können Sie sich einen Voucher (QR-Code) in der Webanwendung (Kortpress Cloud) erstellen lassen und ihn anschließend mit Ihrem Smartphone scannen.
Um einen Voucher anzulegen, gehen Sie in der Webanwendung (Kortpress Cloud) auf das Dashboard. Wählen Sie unter "MEHR" den Eintrag "APP MANAGER" aus. Hier können Sie sich einen Voucher (QR-Code) generieren lassen.

Welcher Pass-Typ eignet sich für Mitgliedskarten wie z.B. für Vereine?

Für Mitglieds- oder Kundenkarten eines Vereins, einer Organisation oder eines Unternehmens eignet sich der Pass-Typ "Treue-/Kundenkarte". Mit dieser Art von digitaler Mitglieds- oder Kundenkarte haben Sie die Möglichkeit digitale Karten für einzelne Mitglieder zu erstellen. Weiterhin bietet dieser Typ die Möglichkeit ein Stufen- oder Punktesystem abzubilden.

Wie kann ich meine E-Mail-Adresse für den Rechnungsversand ändern?

Sie können die Mail-Adresse für den Rechnungsversand im Control Center abändern. Klicken Sie dazu im Dashboard auf das "Kachel"-Icon links neben dem Kortpress Logo und wählen aus dem Drop-Down-Menü den Punkt "Control Center" aus. Danach klicken Sie in der linken Navigation auf "Rechnungen". Über den blauen "E-Mail ändern"-Button können Sie Ihre Mail-Adresse für den Rechnungsversand aktualisieren. Bitte beachten Sie, dass die Mail-Adresse, mit der Sie sich in Kortpress anmelden, nicht geändert werden kann.

Wie kann ich mein Passwort ändern?

Ihr Passwort können Sie in Ihrem Control Center ändern. Klicken Sie dazu im Dashboard auf das "Kachel"-Icon links neben dem Kortpress Logo und wählen aus dem Drop-Down-Menü den Punkt "Control Center" aus. Nun klicken Sie auf das runde "Profil"-Icon rechts oben neben Ihrer Kundennummer und wählen anschließend "Account" aus. Über den blauen "Passwort ändern"-Button können Sie ein neues Passwort setzen.

Wie kann ich meinen Vertrag kündigen?

Sie können Ihren Vertrag über das Control Center kündigen. Klicken Sie dazu im Dashboard auf das "Kachel"-Icon links neben dem Kortpress Logo und wählen aus dem Drop-Down-Menü den Punkt "Control Center" aus. Danach klicken Sie auf "Zu den Vertragsdetails". Über den blauen "Vertrag kündigen"-Button kündigen Sie Ihren laufenden Tarif und der Vertrag mit Kortpress wird aufgehoben.

Wann ist ein Pass aktiv?

Ein Pass und all seine individuellen Installationen sind aktiv und damit abrechnungswürdig, solange sie dem eigenen Account zugeordnet sind. Nachdem ein Pass gelöscht wurde, ist dieser nicht mehr aktiv und wird somit nicht weiter bei der Abrechnung berücksichtigt.

Was ist eine Transaktion?

Kortpress erfasst alle Transaktionen, die mit einem Pass in Verbindung stehen. Hierzu zählen Pass-Erstellungen, Pass-Updates, Pass-Installationen, Push-Nachrichten uvm.

Was ist ein Pass-Update

Ein Pass-Update ist eine Änderung an einem bestehenden Pass oder Template, welches sich auf Passes auswirkt. Aufgrund von technischen Restriktionen ist für den Versand von Push-Notifications ebenfalls ein Pass-Update notwendig.

Wie berechnet sich die Gesamtanzahl der Passes?

Die Gesamtanzahl der Passes ist die Summe aus den erstellten Passes und den Passes, die mehrfach installiert wurden.

Wie kann ich meinen Tarif während eines laufenden Abonnement ändern?

Sie können während eines aktiven Abonnements ganz einfach auf ein anderes Tarifmodell wechseln. Melden Sie sich hierfür in der Kortpress Cloud an, klicken Sie auf das Kortpress Logo im Navigationsmenü und wechseln Sie zum "Control Center". Im Control Center klicken Sie auf "Zu den Vertragdetails" und anschließend auf "Tarif wechseln". Wählen Sie nun ihren gewünschten Tarif aus. Der Tarifwechsel wird dann zum darauffolgenden Monat stattfinden.

Was sind Beacons?

Als Beacons werden kleine Sender oder Empfänger bezeichnet, die mithilfe von Bluetooth Signale in bestimmten Zeitintervallen versenden können. Unsere Kortpress Technologie kann diese Signale aufgreifen, um an bestimmen Bereichen (z. B. an der Kassenzone) Benachrichtigungen auf dem installierten Pass einer Käuferin oder eines Käufers zu aktivieren.

Was ist ein P12-Schlüssel?

Bei einem P12-Schlüssel handelt es sich um ein von Apple herausgegebenes Zertifikat, das von verschiedenen Sicherheits- und Verschlüsselungsprogrammen verwendet wird. Sie benötigen dieses Zertifikat als Teil der Credentials zur Erstellung von Passes und Cards. Eine Mitgliedschaft im Apple Developer Program ist notwendig, um diese Datei zu erhalten und verwenden zu können.

Was passiert mit gelöschten Passes?

Ihre Kunden können ihre vom Smartphone gelöschten Passes, jederzeit wiederherstellen, indem Sie den Pass erneut in ihr mobile Wallet hinzufügen. Vorausgesetzt, diese sind in der Kortpress Webanwendung aktiv hinterlegt.

Welche QR-Codes werden unterstützt?

Mit Kortpress.io können Sie neben dem QR Code weitere gängige Barcodetypen scannen: Code 128, PDF 417 und Aztec-Code.

Welche Möglichkeiten gibt es, um Passes ablaufen zu lassen bzw. zu löschen?

Hierfür gibt es zwei Optionen in der Kortpress Cloud:
1. Pass ablaufen lassen: Sie können auf dem Pass ein Datum setzen, bis wann dieser gültig ist. Nach Ablauf dieses Datums wird der Pass auf dem Gerät des Nutzers verändert dargestellt: Apple graut den Barcode auf dem Pass aus. Google verschiebt den Pass in den Bereich "Abgelaufene Karten". Eignet sich z. B. für: Mitgliedskarten mit einer speziellen Gültigkeit, Eintritts-Tickets die nur eine spezielle Gültigkeit haben, Fahrkarten. Vorteil: Im Gegensatz zur Löschung des Passes hat diese Variante den Vorteil, dass die Karte wieder reaktiviert werden kann. Durch ein Pass Update und die Aktualisierung des Datums wird der Pass wieder gültig.
2. Pass löschen: Sie können einen Pass direkt aus Kortpress löschen oder den Pass zu einem bestimmten Datum zur Löschung vorsehen. In beiden Fällen wird der Pass komplett aus Kortpress gelöscht und auf den Geräten als abgelaufen markiert (siehe 1.) Eignet sich z. B. für: Abbildung von Kündigung/Austritt von Mitgliedern, Einmalige Tickets für Eintrittskarten oder Fahrkarten.

Schritt 1

Sie benötigen einen Apple Developer Account um Apple Pass Type Zertifikate zu erstellen. Zusätzlich brauchen Sie folgende Informationen, um in Kortpress einen Apple Pass zu erstellen:

Melden Sie sich als Administrator bei Ihrer Apple Developer Console an und wählen Sie Certificates, Identifiers & Profiles aus.

Apple Developer Console

Schritt 2

Wählen Sie im Menü links die Option Identifiers aus und klicken Sie auf die Schaltfläche + , um einen neuen Identifier hinzuzufügen. Wählen Sie Pass Type IDs aus der Liste der Identifier aus und klicken Sie auf Weiter. Füllen Sie das Feld Pass Type ID Description aus und vergeben Sie einen neuen eindeutigen Indentifier. Bestätigen Sie Ihre Eingaben und klicken Sie auf Continue. Überprüfen Sie Ihren Namen und Ihren Identifier und registrieren Sie dann Ihre Pass Type ID.

Certificates, Identifiers & Profiles

Schritt 3

Wählen Sie Ihre erstellte Pass Type ID aus der Liste aus. Erstellen Sie einen Certificate Signing Request: (CSR, https://help.apple.com/developer-account/#/devbfa00fef7) und laden Sie es hoch, indem Sie Choose File auswählen.

Create a new Certificate

Schritt 4

Laden Sie Ihr neues Zertifikat herunter. Doppelklicken Sie das Zertifikat, um es Ihrem Schlüsselbund hinzuzufügen. Klicken Sie mit der rechten Maustaste auf Ihr Zertifikat in Keychain Access App, und exportieren Sie es als .p12-Datei. Fügen Sie Ihrem Zertifikat ein Passwort hinzu. Sie müssen sich dieses Passwort merken, um es später auf Kortpress hochladen zu können.

Zertifikat in Kortpress hinzufügen

Die Erstellung der Google Credentials können Sie ganz bequem über unsere Kortpress Webanwendung angehen. Sie brauchen hierfür lediglich Ihre E-Mail Adresse und einen von Ihnen gewählten Account Namen. Wir kümmern uns anschließend um den Rest.

Schritt 1

Sie benötigen einen Apple Developer Account und folgende Informationen, um in Kortpress Push-Benachrichtigungen versenden zu können:

Melden Sie sich als Administrator bei Ihrer Apple Developer Console an und wählen Sie Certificates, Identifiers & Profiles aus.

Apple Pass Zertifikate

Schritt 2

Wählen Sie Keys und fügen Sie einen neuen Schlüssel vom Typ Apple Push Notification Service (APNs) hinzu. Nach dem Erstellen eines Schlüsselnamens klicken Sie auf Register, um die APNs-Zertifikate zu erstellen.

Register a new key

Schritt 3

Laden Sie die APNs-Datei herunter und merken Sie sich die Key-ID. HINWEIS: Der Key kann nur einmal heruntergeladen werden, da die Serverkopie entfernt wird. Bewahren Sie eine Sicherungskopie Ihres Keys an einem sicheren Ort auf. Laden Sie die .p8-Datei mit der entsprechenden Key-ID auf Kortpress hoch.

Neue APNs Credentials erstellen

Falls Sie ein gemeinnütziger Verein oder Organisation sind und Kortpress im Sponsortarif nutzen, wird keine Mitgliedschaft im Apple Developer Program benötigt. Credentials für Apple und Google werden von uns bei Umstellung Ihres Tarifs bereitgestellt. Mehr Informationen zu den Ausweisen für Vereine finden Sie hier: https://kortpress.io/use-cases/mitgliedsausweise/.

Get in touch

We'd love to hear from you

Kontakt