Der createMember-API-Aufruf wird verwendet, um ein kostenloses oder bezahltes Mitglied auf Ihrer Mitgliederseite zu erstellen. Er kann auch verwendet werden, um die Mitgliedschaftsstufe eines bestehenden Mitglieds zu ändern. Wenn die übergebene E-Mail-Adresse mit einem bestehenden Mitglied verknüpft ist und die übergebene Mitgliedschaftsstufen-ID sich von derjenigen unterscheidet, die mit dem Konto des Mitglieds verknüpft ist, ändert MemberMouse die Mitgliedschaftsstufe und kündigt automatisch alle aktiven Abonnements, die mit der aktuellen Mitgliedschaft verknüpft sind.
WICHTIG! Wenn Sie sich dafür entscheiden, rohe Kreditkartendaten über diesen API-Aufruf zu übermitteln, unterliegen Sie einer höheren Stufe der SAQ-Anforderungen für die PCI-Konformität (SAQ-D). Es liegt in Ihrer Verantwortung, sicherzustellen, dass Sie die Anforderungen erfüllen.
Beispiel einer Anfrage-URL
http://{Ihre_API_URL}?q=/createMember
Eingabe-Parameter
Parameter | Beschreibung | Erforderlich |
apikey | API-Schlüssel von MemberMouse API-Anmeldeinformationen | Ja |
apisecret | API-Geheimnis von MemberMouse API-Anmeldeinformationen | Ja |
mitgliedschaft_level_id | ID der Mitgliedsstufe, die dem Konto des neuen Mitglieds zugewiesen werden soll | Ja |
produkt_id | Jeder bezahlten Mitgliedschaftsstufe, die Sie in MemberMouse erstellen, wird ein Standardprodukt zugeordnet. Wenn dieses Feld leer gelassen wird, wird das Standardprodukt für die Bestellung verwendet. Sie können hier optional eine gültige Produkt-ID übergeben, die mit der Mitgliedschaftsstufe verknüpft ist, um einen anderen Preis für die Mitgliedschaftsstufe zu berechnen als das Standardprodukt. | Nein |
E-Mail | E-Mail Adresse des neuen Mitglieds | Ja |
Nutzername | Benutzername für das neue Mitglied. Wenn dieser nicht angegeben wird, wird die E-Mail-Adresse des Mitglieds als Benutzername verwendet. | Nein |
vor_name | Vorname des neuen Mitglieds | Nein |
letzter_name | Nachname des neuen Mitglieds | Nein |
Passwort | Das Passwort, das Sie für das neue Mitglied festlegen möchten. Wenn dieses nicht angegeben wird, generiert MemberMouse automatisch ein Kennwort für das neue Mitglied. | Nein |
Telefon | Telefonnummer des neuen Mitglieds | Nein |
rechnungs_adresse | Rechnungsadresse des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
abrechnung_stadt | Abrechnungsort des neuen Mitglieds. | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
rechnungs_Staat | Rechnungsstatus des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
rechnungsstellung_zip | Rechnungs-Postleitzahl des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
abrechnungs_land | Rechnungsland des neuen Mitglieds (Zweistelliger ISO-Ländercode) | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
kredit_nummer | Kreditkartennummer des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
exp_month | Gültigkeitsmonat der Kreditkarte des neuen Mitglieds (2-stellig) | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
exp_year | Ablaufjahr der Kreditkarte des neuen Mitglieds (4-stellig) | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
sicherheits_code | Sicherheitscode (CVV) der Kreditkarte des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
Versand_gleich_wie_Rechnung | Dies kann auf JA oder NEIN eingestellt werden. Wenn Sie JA wählen, brauchen Sie keine Angaben zur Lieferadresse zu machen. NO ist der Standardwert. | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist) |
Versandmethode | Code der Versandart, die Sie auf die Bestellung anwenden möchten. Sie können Codes für Versandmethoden auf dem Bildschirm "Versandmethoden" in MemberMouse finden. | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
shipping_address | Versandadresse des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
Versand_Stadt | Versandstadt des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
versand_staat | Versandstatus des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
versand_zip | Versand-Postleitzahl des neuen Mitglieds | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
shipping_country | Versandland des neuen Mitglieds (Zweistelliger ISO-Ländercode) | Bedingt (Nein, wenn die Mitgliedschaft kostenlos ist oder die Lieferadresse mit der Rechnungsadresse übereinstimmt) |
Partner_ID | Affiliate ID, die mit der Bestellung erstellt werden soll | Nein |
sub_affiliate_id | ID des Unterpartners, der mit der Bestellung verrechnet werden soll | Nein |
gutschein_code | Gültiger Gutscheincode, den Sie auf die Bestellung anwenden möchten | Nein |
custom_field_[ID#] | Sie können benutzerdefinierte Felddaten an die API übergeben, indem Sie einen oder mehrere Parameter in der Form custom_field_[ID#] übergeben, wobei [ID#] durch die ID des benutzerdefinierten Feldes, wie in MemberMouse definiert, ersetzt wird. Wenn die ID des benutzerdefinierten Feldes beispielsweise 4 ist, würden Sie die Daten für dieses benutzerdefinierte Feld durch Einfügen des Parameters custom_field_4 übergeben. | Nein |
Antwort-Codes
- 200 - Erfolg
- 409 - Neues Mitglied kann nicht erstellt werden
Antwortdaten
Parameter | Beschreibung |
mitglied_id | Die ID des neuen Mitglieds in MemberMouse |
E-Mail | Die E-Mail des neuen Mitglieds |
Nutzername | Den Benutzernamen des neuen Mitglieds |
Passwort | Das Passwort des neuen Mitglieds |
BestätigungUrl | Die URL für die Bestätigungsseite, die mit dem Kauf verbunden ist. Sie ist mit einem Transaktionsschlüssel versehen, damit MemberMouse SmartTags™ auf dieser Bestätigungsseite funktionieren. |