Ormio Hilfe

Hilfe › Ormio Member › Zugang vergeben

Verkauf: Digistore24 & Co.

Der Kauf gibt den Zugang – automatisch, mit Zugangsdaten per Mail.

Digistore24 verbinden

  1. OrmioMember → Verbindungen: Digistore24 hinzufügen und den API-Schlüssel eintragen (die Zugangsdaten werden verschlüsselt gespeichert). Den Schlüssel legst du in Digistore24 unter Einstellungen → Kontozugriff → API-Schlüssel mit Lese- und Schreibzugriff an. Der „Dankeseite-Schlüssel“ aus den Kontoinformationen ist nicht der API-Schlüssel und wird nicht akzeptiert.
  2. „Bei Digistore24 einrichten“ klicken. OrmioMember legt dort die Verbindung selbst an (Typ „Digistore API“), sodass Käufer ihre Zugangsdaten auch von Digistore24 bekommen. Das geht schon, bevor ein Produkt verbunden ist; die Verbindung gilt dann für alle Produkte. Die manuelle IPN-Verbindung bleibt als Alternative.
  3. Im Produkt einen Auslöser mit dem Digistore24-Produkt hinzufügen und das Produkt speichern. Im Kasten siehst du alle Produkte der Verbindung als Liste: Haken setzen fügt ein Produkt hinzu, Haken entfernen nimmt es wieder heraus, danach das Produkt speichern. Ein Eintrag darf auch mehrere OrmioMember-Produkte freischalten (bei Digistore24, Stripe, Copecart, PayPal, WooCommerce, Affilicon, ClickBank und dem Webhook), zum Beispiel ein Gratis-Bonusprodukt für alle Käufer eines Pro-Produkts: Trage es einfach in beiden Produkten als Auslöser ein. Eine Rückerstattung sperrt dann alle diese Produkte.

Danach passiert bei jedem Kauf automatisch: Konto anlegen oder finden, Zugang geben, Zugangsmail senden. Rückerstattung, Kündigung oder fehlgeschlagene Zahlung nehmen den Zugang zurück.

✓
TestenSchalte in der Verbindung „Testkäufe annehmen“ ein, mache einen Testkauf und sieh im Aktivitätsprotokoll nach. Danach wieder ausschalten.

Stripe verbinden (Schritt für Schritt)

Stripe gibt den Zugang bei Zahlungslinks, Checkout und Abos. Du brauchst zwei Dinge von Stripe: einen eingeschränkten Schlüssel (damit OrmioMember deine Produkte lesen kann) und einen Webhook (damit Stripe dem Plugin meldet, wer bezahlt hat). Probiere alles zuerst im Testmodus („Sandbox“, es wird kein Geld bewegt) und mache es danach im Live-Modus noch einmal.

  1. Eingeschränkten Schlüssel anlegen. Stripe → Entwickler → API-Schlüssel → „Eingeschränkten Schlüssel erstellen“. Der Name ist egal (zum Beispiel „OrmioMember“). Gib nur Lesezugriff auf Produkte, Checkout-Sitzungen, Rechnungen und Zahlungen (Charges). Möchtest du, dass OrmioMember für das Angebot (Kongress, Kurs) auch den Link und den Preis aus Stripe liest, gib zusätzlich Lesezugriff auf Preise und Zahlungslinks (Payment Links); ohne diese beiden trägst du Link und Preis von Hand ein. Die Vorlage „Berichterstattung, Analysen und Buchhaltung“ reicht nicht, ihr fehlen die Checkout-Sitzungen. Tipp: Mit diesem Link ist alles schon vorausgefüllt, auch Preise und Zahlungslinks (Testmodus): https://dashboard.stripe.com/test/apikeys/create?name=OrmioMember&permissions[0]=rak_product_read&permissions[1]=rak_checkout_session_read&permissions[2]=rak_invoice_read&permissions[3]=rak_charge_read&permissions[4]=rak_plan_read&permissions[5]=rak_payment_links_read. Für den Live-Modus lässt du das /test weg. Der Schlüssel beginnt mit rk_test_ (Test) oder rk_live_ (Live) und wird nur einmal angezeigt: gleich kopieren.
  2. In OrmioMember verbinden. OrmioMember → Verbindungen → Stripe → „Stripe verbinden“. Den Schlüssel in das Feld „Eingeschränkter API-Schlüssel“ einfügen. Das Feld „Webhook-Signing-Secret“ lässt du noch leer (das gibt es erst in Schritt 4). Auf „Verbinden und prüfen“ klicken: es muss „Verbunden. Die Zugangsdaten wurden erfolgreich geprüft.“ erscheinen.
  3. Die Werte für Stripe öffnen. Auf der Stripe-Karte „Einrichtungswerte für den Anbieter“ aufklappen. Dort stehen die Endpunkt-Adresse (…/wp-json/ormio-member/v1/stripe/…) und die Liste der Ereignisse.
  4. Webhook bei Stripe anlegen. Stripe → Entwickler/Workbench → Webhooks → „Ziel hinzufügen“. Wähle: Ereignisse von „Ihr Konto“, Nutzlast-Stil „Momentaufnahme“ (nicht „Thin“), dann diese acht Ereignisse: checkout.session.completed, checkout.session.async_payment_succeeded, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted, charge.refunded, charge.dispute.created. Die API-Version lässt du auf der vorgeschlagenen (zum Beispiel 2020-08-27); OrmioMember versteht auch neuere Versionen. Zieltyp „Webhook-Endpoint“, bei Endpoint-URL die Adresse aus OrmioMember einfügen, Namen vergeben, „Ziel erstellen“. Schneller geht es mit diesem Link, der die acht Ereignisse schon ausgewählt hat: https://dashboard.stripe.com/test/workbench/webhooks/create?events=checkout.session.async_payment_succeeded,checkout.session.completed,invoice.paid,invoice.payment_failed,customer.subscription.deleted,customer.subscription.updated,charge.refunded,charge.dispute.created (Live: ohne /test). Die Suche in der Ereignisliste braucht zwei Sekunden, bis sie filtert.
  5. Signing-Secret übertragen. Auf der Seite des neuen Ziels steht rechts „Signatur-Geheimnis“ (whsec_…, verdeckt). Auf das Auge-Symbol klicken und das Geheimnis kopieren. In OrmioMember bei der Stripe-Karte „Zugangsdaten ändern“ aufklappen, das Geheimnis in „Webhook-Signing-Secret“ einfügen, das Schlüsselfeld leer lassen („Gespeichert · leer lassen zum Beibehalten“) und „Speichern und prüfen“ klicken.
  6. Produkt verknüpfen. Im OrmioMember-Produkt im Kasten „Wie erhalten Käufer dieses Produkt?“ bei der Auswahl dein Stripe-Produkt wählen (sie stehen unter „Stripe · <Name der Verbindung> — Stripe-Produkt“), „Auslöser hinzufügen“, Produkt veröffentlichen. Ein Stripe-Produkt kann nur ein OrmioMember-Produkt freischalten. Auslöser wirken nur bei veröffentlichten Produkten.
  7. Testen. Lege in Stripe (Testmodus) ein Produkt und einen Zahlungslink an und bezahle mit der Testkarte 4242 4242 4242 4242 (beliebiges Ablaufdatum in der Zukunft, beliebige Prüfziffer). Im Aktivitätsprotokoll erscheinen „Benutzerkonto angelegt“, „Zahlung eingegangen“ und „Zugangsmail“; der Käufer bekommt die Zugangsmail sofort.
  8. Rückerstattung testen. Stripe → Transaktionen → die Testzahlung öffnen → oben auf „Rückerstattung“ klicken → im Fenster erneut auf „Rückerstattung“ (Betrag voll, Grund „Auf Wunsch des Kunden“). Nach wenigen Sekunden steht im Aktivitätsprotokoll „Zugang sperren“ mit der Herkunft Stripe. Das Konto bleibt bestehen, nur der Zugang zum Produkt ist weg.

Danach passiert bei jedem Kauf automatisch: Konto anlegen oder finden, Zugang geben, Zugangsmail senden. Eine Rückerstattung oder ein Rückbuchungs-Streit nehmen den Zugang zurück, ein gekündigtes Abo endet zum Ende des bezahlten Zeitraums, eine fehlgeschlagene Abo-Zahlung pausiert den Zugang.

✓
Test und Live sind getrenntSchlüssel, Webhook und Signing-Secret gelten nur für den Modus, in dem du sie angelegt hast. Für den Live-Betrieb legst du alle drei noch einmal im Live-Modus an, und zwar als zweite Stripe-Verbindung in OrmioMember („Weiteres Stripe-Konto hinzufügen“, am besten „Stripe Test“ und „Stripe Live“ benennen). Jede Verbindung hat ihre eigene Webhook-Adresse: Der Live-Webhook bei Stripe bekommt die Adresse der Live-Verbindung. Auch die Produkte gibt es in Stripe getrennt (Test-Produkte existieren live nicht): Lege sie im Live-Modus an und verknüpfe im OrmioMember-Produkt zusätzlich den Auslöser mit dem Live-Produkt. Für Live braucht dein Stripe-Konto die abgeschlossene Freischaltung (Firmen- und Bankdaten bei Stripe).
!
„Prüfung fehlgeschlagen“?Meist ist es der Schlüssel: Er muss mit rk_ beginnen (nicht pk_), vollständig und ohne Leerzeichen kopiert sein und zum selben Modus wie deine Produkte gehören. Meldet OrmioMember „dem Schlüssel fehlen Rechte“, fehlt ein Lesezugriff aus Schritt 1. Kommt beim Kauf nichts an, schaue bei Stripe am Webhook-Ziel unter „Ereignisübermittlungen“ nach, ob Ereignisse ankamen, und prüfe das Signing-Secret.

Affilicon verbinden (Schritt für Schritt)

Bei Affilicon schickt Affilicon dem Plugin bei jedem Kauf und jeder Erstattung eine Meldung (bei Affilicon heißt das „ITNS“). Du brauchst dafür eine Adresse, die OrmioMember für dich erzeugt, und trägst sie bei Affilicon im Produkt ein. Einen Schlüssel musst du nicht besorgen: Der Schutz steckt schon in der Adresse.

Teil 1: OrmioMember mit Affilicon verbinden

  1. Adresse erzeugen. OrmioMember → Verbindungen → Zahlungsanbieter → Karte „Affilicon“ (Status „Nicht verbunden“). Unter „Schritt 1: Adresse erzeugen“ steht das Feld „Name (nur zur Orientierung)“ (darf leer bleiben) und der Haken „Affilicon-Testkäufe auch als echte Käufe annehmen (nur zum Testen)“. Für den Testkauf in Teil 4 setzt du diesen Haken. Dann auf „Adresse erzeugen“ klicken.
  2. Ergebnis ansehen. Oben erscheint „Adresse erzeugt. Als Nächstes: trage sie beim Anbieter ein (Schritt 2 unten). …“. Die Karte zeigt jetzt den Status „Adresse erzeugt – wartet auf die erste Meldung“. Das ist richtig: Verbunden ist sie erst, wenn Affilicon die erste Meldung geschickt hat.
  3. Adresse kopieren. Unter „Schritt 2: Diese Adresse beim Anbieter eintragen“ steht das Feld „ITNS-URL“. Ein Klick in das Feld kopiert die Adresse in die Zwischenablage.
  4. Bei Affilicon eintragen. Auf affilicon.net oben auf „Login“ klicken. Im Menü links „Verwaltung“ → „Produkte“, in der Zeile deines Produkts auf das Stift-Symbol klicken („Produkt bearbeiten“) und den Reiter „Anbindungen“ öffnen. Dort „Neue Anbindung hinzufügen“ klicken, in der Gruppe „Allgemein“ „klassische ITNS-Anbindung“ wählen und die Adresse in das Feld „ITNS-URL“ einfügen. „Präfix“ und „Secret Key“ lässt du leer. Auf „Hinzufügen“ klicken, dann ganz unten auf „Aktualisieren“.
  5. Prüfen, dass es gespeichert ist. Bei „Aktualisieren“ erscheint keine sichtbare Bestätigung. Lade die Seite des Produkts neu und öffne den Reiter „Anbindungen“: Dort muss der Eintrag „klassische ITNS-Anbindung“ stehen.
✓
Secret Key und Präfix: nicht nötigBeide Felder sind bei Affilicon freiwillig. Die Adresse schützt die Meldungen schon. Möchtest du die zusätzliche Prüfung, legst du den Secret Key bei Affilicon selbst fest (du denkst ihn dir aus) und trägst denselben Wert bei OrmioMember unter „Zugangsdaten ändern“ ein, ebenso ein Präfix. Beide Seiten müssen dann genau übereinstimmen, sonst werden die Meldungen abgelehnt.

Teil 2: Produkt bei Affilicon anlegen

Hast du bei Affilicon schon ein Produkt, springst du zu Teil 3. Sonst:

  1. Neues Produkt öffnen. Auf my.affilicon.net im Menü „Verwaltung“ → „Produkte“, oben rechts auf „Neues Produkt“ klicken. Es öffnet sich die Seite „Neues Produkt“ mit den Schritten „Produktdaten“, „Erweiterte Einstellungen“, „Anbindungen“, „Bestellformular“, „Cross-Selling“ und „Conversion-Tools“. Pflicht ist nur „Produktdaten“.
  2. Produktart. Unter „Produkt-Einstellungen“ bleibt „Standard-Produkt“ gewählt (für ein Abo „Abo-Produkt“). „Mehrsprachigkeit“ lässt du aus.
  3. Name und Kategorie. Unter „Beschreibung und Kategorie“ trägst du den „Produktname“ ein und wählst in der Liste „Kategorie“ den Eintrag „Membershipzugänge“. Darunter erscheint ein Hinweis zum FernUSG: Prüfe vor der Freigabe, ob dein Produkt darunter fällt.
  4. Preis. Unter „Preise und Affiliate-Provisionen“ trägst du den „Bruttopreis des Produkts“ ein (zum Beispiel 37,00). „Affiliate Provision“ kann bei 0 % bleiben.
  5. Adressen. Unter „E-Mail-Adressen und Links“ sind vier Felder Pflicht: „Verkaufsseite Ihres Produkts“, „Abschlusslink / Downloadlink“ (zum Beispiel die Anmeldeseite deiner Mitgliederseite), „E-Mail-Adresse für Verkaufsbenachrichtigung“ und „Ihre Support E-Mail-Adresse“.
  6. Speichern. Ganz unten auf „Speichern“ klicken. Affilicon zeigt eine grüne Meldung und öffnet „Produkt bearbeiten“. In „Verwaltung“ → „Produkte“ steht das Produkt jetzt mit seiner „ID: …“ und dem Status „Entwurf“. Den Status ändert erst die Freigabe durch Affilicon („Freigabe beantragen“). Zum Testen genügt der Entwurf.
  7. Adresse eintragen. Im Produkt den Reiter „Anbindungen“ öffnen: „Neue Anbindung hinzufügen“ → „klassische ITNS-Anbindung“ → die Adresse aus OrmioMember (Teil 1) in „ITNS-URL“ einfügen → „Hinzufügen“ → unten „Aktualisieren“. Danach die Seite neu laden: Im Reiter „Anbindungen“ steht der Eintrag „klassische ITNS-Anbindung“.

Teil 3: Das Affilicon-Produkt mit dem OrmioMember-Produkt verknüpfen

Bei Affilicon heißt es auch „Produkt“. Jedes hat eine Nummer.

  1. Produkt-ID bei Affilicon nachsehen. „Verwaltung“ → „Produkte“: Unter dem Namen des Produkts steht „ID: …“ (zum Beispiel 35650). Diese Nummer brauchst du gleich.
  2. OrmioMember-Produkt öffnen oder anlegen. OrmioMember → Produkte → „Neues Produkt“ (oder ein vorhandenes Produkt bearbeiten). Einen Titel vergeben und im Kasten „Enthaltene Kurse“ die Kurse ankreuzen, die der Kauf freischalten soll.
  3. Affilicon eintragen. Im Kasten „Wie erhalten Käufer dieses Produkt?“ gibt es den Abschnitt „Oder eine Artikelnummer von Hand eingeben“. In der Auswahl „Affilicon · …“ (der Name deiner Verbindung) die Affilicon-Verbindung wählen und die Nummer aus Schritt 1 in das Feld „Artikelnummer oder Produkt-ID“ schreiben.
  4. Veröffentlichen. Auf „Veröffentlichen“ (oder „Aktualisieren“) klicken. Auslöser wirken nur, solange das Produkt veröffentlicht ist.
  5. Prüfen. Im Kasten „Wie erhalten Käufer dieses Produkt?“ steht jetzt die Zeile „Affilicon-Produkt-ID: 35650“ (mit deiner Nummer) und „Benachrichtigungen dieses Produkts von Affilicon geben Zugang.“ Ein Affilicon-Produkt kann auch mehrere OrmioMember-Produkte freischalten: Trage dieselbe Nummer einfach in beiden Produkten ein.
✓
Weiteres ProduktDu brauchst keine zweite Verbindung. Die Adresse gehört zu deinem Affilicon-Konto, nicht zu einem Produkt. Trage sie bei Affilicon in jedem weiteren Produkt ein (Reiter „Anbindungen“ → „klassische ITNS-Anbindung“ → „ITNS-URL“ → „Hinzufügen“ → „Aktualisieren“) und im passenden OrmioMember-Produkt die Affilicon-Produkt-ID. Kopierst du ein Produkt bei Affilicon über das Symbol „Duplizieren“ (Produktzeile unter „Verwaltung“ → „Produkte“), übernimmt die Kopie die ITNS-Anbindung samt Adresse; dann fehlt nur noch die neue Produkt-ID in OrmioMember. Meldet Affilicon ein Produkt, dessen ID in keinem OrmioMember-Produkt steht, ignoriert OrmioMember die Meldung.

Teil 4: Testkauf – der Beweis, dass es funktioniert

  1. Testkauf auslösen. Bei Affilicon „Verwaltung“ → „Produkte“ → Stift-Symbol → ganz unten auf „Testkauf“ klicken. Es öffnet sich in einem neuen Tab das Bestellformular („Sichere Zahlung per Lastschrift“). Nimm für den Kauf eine Test-Adresse, zum Beispiel name+test@gmail.com, denn daran legt OrmioMember das Mitglied an. Ausfüllen und „Jetzt kaufen“ klicken.
  2. Bei OrmioMember nachsehen. OrmioMember → Verbindungen → Zahlungsanbieter → Affilicon: Die Karte zeigt jetzt „Verbunden“, und beim Punkt „Letzter Aufruf“ steht Datum, Uhrzeit und „angenommen (SALE)“. Im Aktivitätsprotokoll stehen für die Test-Adresse „Benutzerkonto angelegt“, „Zahlung eingegangen“ (mit dem Produkt und der Herkunft Affilicon) und „Zugangsmail“.
  3. Erstattung testen. Bei Affilicon „Berichte“ → „Verkäufe“, die Zeile des Testkaufs anklicken (Zahlart „Testkauf“). Unten bei den Verkaufsdetails im Abschnitt „Rückgabe“ den Betrag eintragen und auf „Ausführen“ klicken. Bei OrmioMember steht dann bei „Letzter Aufruf“ „angenommen (RFND)“, und das Aktivitätsprotokoll zeigt „Zugang sperren“ mit der Herkunft Affilicon. Das Konto bleibt bestehen, nur der Zugang zum Produkt ist weg.
  4. Aufräumen. Haken „Affilicon-Testkäufe auch als echte Käufe annehmen (nur zum Testen)“ wieder ausschalten: Karte → „Zugangsdaten ändern“.
!
Fehlerseite nach „Jetzt kaufen“?Bei unserem Testkauf zeigte Affilicon nach „Jetzt kaufen“ die Seite „An error has occured“. Die Meldung an OrmioMember war trotzdem angekommen. Verlass dich deshalb nicht auf die Seite von Affilicon, sondern sieh bei OrmioMember nach („Verbunden“, „Letzter Aufruf“, Aktivitätsprotokoll). Die Bestellung steht in diesem Fall trotzdem bei Affilicon unter Berichte → Verkäufe. Bleibt dort alles leer, prüfe bei Affilicon, ob der Eintrag „klassische ITNS-Anbindung“ im Produkt gespeichert ist, und ob die Adresse vollständig eingefügt wurde.

Weitere Anbieter

AnbieterEinrichtung
StripeEingeschränkter Schlüssel plus Webhook, Schritt für Schritt oben unter „Stripe verbinden“.
AffiliconAdresse in OrmioMember erzeugen, bei Affilicon im Produkt als „klassische ITNS-Anbindung“ eintragen, Produkt-ID im OrmioMember-Produkt verknüpfen; Schritt für Schritt oben unter „Affilicon verbinden“.
PayPalUnter Einstellungen → Benachrichtigungen (IPN) die Adresse eintragen; jeder PayPal-Button bekommt die Artikelnummer, die du im Produkt verknüpfst.
CopecartUnter Einstellungen → IPN eine Verbindung mit Adresse und Geheimnis anlegen, alle Ereignisse wählen, Test-Knopf benutzen.
WooCommerceNichts einzurichten: Bestellungen geben den Zugang für die Produkte, die du im OrmioMember-Produkt verknüpfst. Erstattungen und Stornos nehmen ihn zurück.
BrevoFür Freebies über Listen: auf der Karte „Bei Brevo einrichten“ klicken (Webhook und Bestätigungsmail entstehen automatisch), dann den Auslöser „Brevo-Liste“ im Produkt wählen und den Shortcode einsetzen.
CleverReachFür Freebies über Listen: OAuth2-App anlegen, Client-ID und Secret eintragen, in CleverReach Liste und eingebettetes Formular anlegen, im Produkt den Auslöser „CleverReach-Gruppe“ wählen (Webhook entsteht automatisch), Formular-Code einfügen und den Shortcode einsetzen.
MailerLiteFür Freebies über Gruppen: Webhook für bestätigte Kontakte mit der angezeigten Adresse und dem Token anlegen.

Alle Adressen und Schlüssel zeigt die jeweilige Verbindung unter Verbindungen an.