Documentation

1Abonnés

Un abonné représente votre client réel. Il offre un moyen simple de traiter les paiements. En général, vous stockerez des données supplémentaires sur l’objet abonné, comme une adresse ou un external_id qui identifie l’abonné dans votre système. L’adresse e-mail est un champ required qui doit être fourni pour l’abonné.

1.1Créer un abonné via le backend

Vous pouvez créer des abonnés via le backend en cliquant sur Space > Abonnement > Abonnés.

iframe
Figure 1. Créer un abonné via le backend.
Note
Vous avez la possibilité d’autoriser et d’interdire explicitement des modes de paiement sur l’abonné. Cela remplace la configuration définie sur le produit d’abonnement. Pour les abonnements, il est important de noter que vous ne pouvez utiliser que des connecteurs qui prennent en charge la tokenisation. Vous pouvez vérifier si la fonctionnalité est prise en charge sur la page d’informations des connecteurs.
iframe
Figure 2. Vérifiez la fonctionnalité prise en charge sur la page d’informations des connecteurs. Ici à titre d’exemple pour le connecteur Bogus AMEX.

Lors de la création, vous devriez fournir autant d’informations que possible. Si des informations supplémentaires sont nécessaires pour créer un paiement avec un mode de paiement spécifique, nous les demanderons au cours du processus de paiement.

1.1.1Web Service API

Vous pouvez également utiliser l’API du service web pour créer (create) un abonné via le Subscriber Service.

Une fois le client créé, vous pouvez abonner le client à un plan en créant un abonnement.

Request

{
	"billingAddress": {
		"city": "Winterthur",
		"country": "Switzerland",
		"emailAddress": "kruesi@customweb.com",
		"familyName": "Kruesi",
		"gender": "MALE",
		"givenName": "Sascha",
		"postcode": "8400",
		"street": "General-Guisan-Strasse 47"
	},
	"emailAddress": "sascha.kruesi@customweb.com",
	"externalId": "customer-nr-101",
	"reference": "customer-nr-101",
	"shippingAddress": {
		"city": "Winterthur",
		"country": "Switzerland",
		"emailAddress": "kruesi@customweb.com",
		"familyName": "Kruesi",
		"gender": "MALE",
		"givenName": "Sascha",
		"postcode": "8400",
		"street": "General-Guisan-Strasse 47"
	}
}

Response

{
	"additionalAllowedPaymentMethodConfigurations": [],
	"description": null,
	"disallowedPaymentMethodConfigurations": [],
	"emailAddress": "sascha.kruesi@customweb.com",
	"externalId": "customer-nr-101",
	"id": 1,
	"language": "en-GB",
	"linkedSpaceId": 1,
	"plannedPurgeDate": null,
	"reference": "customer-nr-101",
	"state": "ACTIVE",
	"version": 1
}

1.2Supprimer un abonné via le backend.

Vous pouvez supprimer des abonnés via le backend en cliquant sur le bouton de suppression dans Space > Abonnement > Abonnés.

1.3Supprimer un abonné via l’API du service web

Vous pouvez également utiliser l’API du service web pour supprimer (delete) un abonné via le Subscriber Service.

Staging 2.218.3