1Abonnenten

Ein Abonnent repräsentiert Ihren tatsächlichen Kunden. Er bietet eine einfache Möglichkeit, Zahlungen zu verarbeiten. Typischerweise speichern Sie zusätzliche Daten auf dem Abonnentenobjekt, wie eine Adresse oder eine external_id, die den Abonnenten in Ihrem System identifiziert. Die E-Mail-Adresse ist ein required Feld, das für den Abonnenten angegeben werden muss.

1.1Einen Abonnenten über das Backend erstellen

Sie können Abonnenten über das Backend erstellen, indem Sie auf Space > Abonnement > Abonnenten klicken.

Figure 1. Einen Abonnenten über das Backend erstellen.

Note

Sie haben die Möglichkeit, Zahlarten auf dem Abonnenten explizit zu erlauben oder zu verbieten. Dies überschreibt die Konfiguration auf dem Abonnementprodukt. Für Abonnements ist es wichtig zu beachten, dass Sie nur Connectoren verwenden können, die Tokenisierung unterstützen. Ob die Funktion unterstützt wird, sehen Sie auf der Connector-Informationsseite.

Figure 2. Prüfen Sie die unterstützte Funktion auf der Connector-Informationsseite. Hier als Beispiel für den Bogus-AMEX-Connector.

Bei der Erstellung sollten Sie so viele Informationen wie möglich angeben. Falls zusätzliche Informationen erforderlich sein sollten, um eine Zahlung mit einer bestimmten Zahlart zu erstellen, fragen wir diese im Zahlungsprozess ab.

1.1.1Web Service API

Alternativ können Sie auch die Web-Service-API verwenden, um einen Abonnenten über den Subscriber Service zu erstellen (create).

Sobald der Kunde erstellt ist, können Sie den Kunden auf einen Plan abonnieren, indem Sie ein Abonnement erstellen.

Request

{
	"billingAddress": {
		"city": "Winterthur",
		"country": "Switzerland",
		"emailAddress": "[email protected]",
		"familyName": "Kruesi",
		"gender": "MALE",
		"givenName": "Sascha",
		"postcode": "8400",
		"street": "General-Guisan-Strasse 47"
	},
	"emailAddress": "[email protected]",
	"externalId": "customer-nr-101",
	"reference": "customer-nr-101",
	"shippingAddress": {
		"city": "Winterthur",
		"country": "Switzerland",
		"emailAddress": "[email protected]",
		"familyName": "Kruesi",
		"gender": "MALE",
		"givenName": "Sascha",
		"postcode": "8400",
		"street": "General-Guisan-Strasse 47"
	}
}

Response

{
	"additionalAllowedPaymentMethodConfigurations": [],
	"description": null,
	"disallowedPaymentMethodConfigurations": [],
	"emailAddress": "[email protected]",
	"externalId": "customer-nr-101",
	"id": 1,
	"language": "en-GB",
	"linkedSpaceId": 1,
	"plannedPurgeDate": null,
	"reference": "customer-nr-101",
	"state": "ACTIVE",
	"version": 1
}

1.2Einen Abonnenten über das Backend löschen.

Sie können Abonnenten über das Backend löschen, indem Sie auf die Schaltfläche zum Löschen innerhalb von Space > Abonnement > Abonnenten klicken.

1.3Einen Abonnenten über die Web-Service-API löschen

Alternativ können Sie auch die Web-Service-API verwenden, um einen Abonnenten über den Subscriber Service zu löschen (delete).

1 Abonnenten