Oggetti Source e CustomerObsoleto
Scopri come associare gli oggetti Source agli oggetti Customer e come gestirli.
Avviso
We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.
While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.
Un oggetto Source può essere monouso o riutilizzabile, in base a quanto specificato dal suo parametro usage. Mentre è possibile addebitare direttamente un importo su un oggetto Source, un oggetto reusable sources deve essere sempre associato a un oggetto Customer per poter essere riutilizzato successivamente. L’associazione di oggetti Source riutilizzabili a oggetti Customer ti consente di presentare ai tuoi clienti un elenco di modalità di pagamento che hanno già usato in precedenza, con il sito web o con l’app.
Source riutilizzabili
Per consentirti di creare pagamenti aggiuntivi senza che il tuo cliente debba di nuovo completare la procedura di pagamento, alcune modalità di pagamento (come gli addebiti diretti SEPA) sono compatibili con oggetti Source riutilizzabili. Il parametro usage di un Source riutilizzabile è impostato su reusable.
Prima di effettuare una richiesta di addebito, devi associare un oggetto Source riutilizzabile a un oggetto Customer. Se addebiti un importo su un oggetto Source riutilizzabile senza aver creato l’associazione, l’oggetto Source viene consumato (il suo stato passa da chargeable a consumed). Gli oggetti Source consumati non potranno essere riutilizzati per ulteriori pagamenti.
Associare un oggetto Source a un nuovo oggetto Customer
Puoi creare un oggetto Customer e associarlo a un Source con una sola chiamata API. Questa procedura è molto utile quando incontri un cliente per la prima volta.
L’oggetto Source diventa l’origine predefinita dell’oggetto Customer, dato che questa è la prima e unica modalità di pagamento usata dal cliente. Quando effettui una richiesta di addebito usando il parametro customer senza specificare il valore del parametro source, l’origine predefinita viene selezionata automaticamente.
Associare un oggetto Source a un oggetto Customer esistente
Quando aggiorni un oggetto Customer che ha un’origine predefinita, viene rimossa l’associazione con l’origine preesistente e l’origine fornita viene specificata come predefinita in modo automatico. Per aggiungere un’origine senza rimuovere l’origine predefinita esistente, utilizza il metodo associa come mostrato di seguito.
In questo caso, dato che potrebbe già esistere un’origine predefinita per l’oggetto Customer, l’origine appena associata non diventa l’origine predefinita. Puoi comunque modificare l’origine predefinita aggiornando l’oggetto Customer e specificando l’origine come valore del parametro default_.
Addebitare un importo su un oggetto Source associato
Quando effettui una richiesta di addebito, devi specificare sia l’oggetto Customer che l’oggetto Source.
Se cerchi di addebitare un importo su un oggetto Customer senza specificare un oggetto Source, Stripe usa l’origine predefinita del cliente.
Rimuovere l’associazione a un oggetto Source
Se vuoi rimuovere un’origine da uno specifico oggetto Customer, puoi rimuovere l’associazione all’oggetto Source. Questo fa passare lo stato dell’oggetto Source a consumed, in modo che non possa essere riutilizzato dopo la rimozione dell’associazione.
Oggetti Source monouso
Gli oggetti Source monouso devono essere creati ogni volta che un cliente effettua un pagamento e non possono essere riutilizzati. Per questo motivo, non ti consigliamo di associarli ai clienti in modo permanente.
Se vuoi associare un pagamento a uno specifico oggetto Customer, puoi includere un parametro customer in una richiesta di addebito con un oggetto Source, anche se questo non è associato.
L’oggetto Charge così creato fa riferimento a entrambi gli oggetti Customer e Source, anche se i due oggetti non sono direttamente collegati l’uno all’altro.