Documentazione

1Abbonati

Un abbonato rappresenta il vostro cliente effettivo. Offre un modo semplice per elaborare i pagamenti. In genere, memorizzerete dati aggiuntivi sull’oggetto abbonato, come un indirizzo o un external_id che identifica l’abbonato nel vostro sistema. L’indirizzo e-mail è un campo required che deve essere fornito per l’abbonato.

1.1Creare un abbonato tramite il backend

Potete creare abbonati tramite il backend cliccando su Space > Abbonamento > Abbonati.

iframe
Figure 1. Creare un abbonato tramite il backend.
Note
Avete la possibilità di consentire e vietare esplicitamente tipi di pagamento sull’abbonato. Questo sovrascrive la configurazione sul prodotto di abbonamento. Per gli abbonamenti è importante notare che potete utilizzare solo connettori che supportano la tokenizzazione. Se la funzionalità è supportata potete verificarlo sulla pagina informativa dei connettori.
iframe
Figure 2. Verificate la funzionalità supportata sulla pagina informativa dei connettori. Qui come esempio per il connettore Bogus AMEX.

Al momento della creazione dovreste fornire quante più informazioni possibili. Nel caso in cui informazioni aggiuntive fossero necessarie per creare un pagamento con un tipo di pagamento specifico, ve le chiederemo durante il processo di pagamento.

1.1.1Web Service API

In alternativa, potete anche utilizzare l’API del servizio web per creare (create) un abbonato tramite il Subscriber Service.

Una volta creato il cliente, potete abbonare il cliente a un piano creando un abbonamento.

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.2Eliminare un abbonato tramite il backend.

Potete eliminare abbonati tramite il backend cliccando sul pulsante di eliminazione all’interno di Space > Abbonamento > Abbonati.

1.3Eliminare un abbonato tramite l’API del servizio web

In alternativa, potete anche utilizzare l’API del servizio web per eliminare (delete) un abbonato tramite il Subscriber Service.

Staging 2.218.1