API SourcesObsoleto

Gli oggetti Source ti consentono di accettare varie modalità di pagamento con una singola API. Un oggetto Source rappresenta un’origine, ovvero uno strumento di pagamento del cliente che può essere usato con l’API Stripe per creare pagamenti. Puoi usare gli oggetti Source per addebiti diretti oppure puoi associarli ai clienti e usarli successivamente.

Ciascuna modalità di pagamento supportata dall’API Sources è definita da quattro caratteristiche chiave. La combinazione di queste caratteristiche determina le modalità per l’addebito sull’origine e per il suo utilizzo in una richiesta di addebito per completare un pagamento.

• Pull o push: modalità di trasferimento dei fondi dal cliente in base alla modalità di pagamento.
• Flusso: tipo di azione che il cliente deve eseguire per autenticare il pagamento.
• Utilizzo: specifica se Source è riutilizzabile o no.
• Sincrono o asincrono: specifica se la conferma dell’addebito risultante può essere immediata o solo differita.

Per un esempio completo che mostra come accettare qualsiasi modalità di pagamento usando l’API Sources, consulta questo esempio di negozio e-commerce ed esplora il suo codice sorgente su GitHub.

Modalità di pagamento supportate

Puoi attivare qualsiasi modalità di pagamento a tua disposizione nella Dashboard. L’attivazione è generalmente immediata e non richiede contratti aggiuntivi né lunghe procedure. Per un elenco dettagliato, consulta le modalità di pagamento disponibili e le regioni geografiche supportate.

La seguente tabella associa le caratteristiche chiave sopra elencate alle modalità di pagamento supportate:

Pull o push di fondi

Ogni modalità di pagamento è classificata come pull o push in base a come i fondi vengono trasferiti dalla modalità di pagamento del cliente.

• Usando una modalità pull, addebiti i fondi sull’account del cliente dopo che il cliente ha rilasciato il consenso. I pagamenti con carta sono un esempio di modalità pull: l’addebito sulla carta del cliente avviene all’esecuzione di un pagamento e nessuna interazione con il cliente è richiesta per gli addebiti successivi.
• Utilizzando una modalità push, è il cliente a inviarti i fondi. I bonifici ACH sono un esempio di modalità push: il cliente dispone dei numeri di routing della banca e dell’account a cui inviare (push) l’importo corretto. Dopo la conferma che il cliente ti ha inviato i fondi, l’origine diventa addebitabile ed è pronta per essere utilizzata in una richiesta di addebito. Altre modalità di pagamento push, come iDEAL o Sofort, si basano su un reindirizzamento che consente al cliente di inviarti il denaro direttamente dal proprio conto bancario. Solitamente, le modalità push richiedono un’interazione con il cliente per ciascun pagamento.

Flusso dell’azione del cliente

Per alcune modalità di pagamento, è necessario che il cliente completi una specifica azione (flusso) prima che l’origine diventi addebitabile. Il tipo di flusso che si applica a una modalità di pagamento è specificato nel parametro flow dell’oggetto Source. Ciascuna modalità è classificata secondo i seguenti tipi di flusso.

Nessuna azione del cliente

Flusso di reindirizzamento

Flusso di verifica del codice

Flusso del destinatario

Nessuna azione è necessaria da parte del cliente. Alcune modalità di pagamento (generalmente le modalità pull), come le carte (ad eccezione di 3D Secure), non richiedono un’autenticazione aggiuntiva oltre alla raccolta delle informazioni di pagamento dai clienti. Gli oggetti Source che rappresentano questa modalità di pagamento possono essere utilizzati immediatamente, quando si effettuano richieste di addebito.

Quando il flusso previsto è stato completato e l’origine diventa addebitabile, l’origine deve essere usata per effettuare una richiesta di addebito per poter completare il pagamento. In caso contrario, l’origine viene eliminata e il pagamento autenticato del cliente viene rimborsato automaticamente, senza spostare denaro sul tuo account.

Monouso o riutilizzabile

Alcune modalità di pagamento consentono la creazione di oggetti Source che possono essere riusati per pagamenti aggiuntivi senza che il cliente debba completare di nuovo l’elaborazione del pagamento. Gli oggetti Source che possono essere riusati hanno il parametro usage impostato su reusable.

Se invece l’oggetto Source può essere usato solo una volta, questo parametro è impostato su single_use e sarà necessario creare un oggetto Source ogni volta che un cliente effettua un pagamento. Tali oggetti non devono essere associati ai clienti, ma devono invece essere usati per l’addebito diretto. Possono essere usati per l’addebito solo una volta, dopodiché il loro stato passa a consumed.

Per poter essere riutilizzati, gli oggetti Source riutilizzabili devono essere associati a un oggetto Customer. In caso di addebito diretto, il loro stato diventa consumed. Per sapere come associare oggetti Source a oggetti Customer e gestire un elenco di Source per Customer, consulta la guida Oggetti Source e Customer.

Conferma sincrona e asincrona

Dopo aver creato un oggetto Charge usando una modalità di pagamento, lo stato dell’addebito può essere confermato immediatamente (in modo sincrono) oppure dopo un determinato periodo di tempo (in modo asincrono).

• Con una modalità di pagamento sincrona, lo stato della richiesta dell’addebito può essere confermato immediatamente come succeeded o failed. Se la richiesta di addebito ha avuto esito positivo, il pagamento è completato, ovvero si considera garantito che l’addebito sul cliente è stato effettuato e che riceverai i fondi. I pagamenti con carta sono un esempio di modalità di pagamento sincrona: c’è una conferma in tempo reale dell’esito positivo o negativo del pagamento.

• Per i metodi di pagamento asincroni, possono trascorrere alcuni giorni prima di ricevere la conferma dell’esito positivo del pagamento. Durante questo periodo, il pagamento non può essere garantito. Lo stato dell’oggetto Charge del pagamento viene inizialmente impostato su pending e resta tale fino alla conferma dell’esito positivo o negativo. Gli addebiti ACH sono un esempio di modalità asincrona: con questi addebiti, sono necessari alcuni giorni per ricevere conferma dell’esito positivo del pagamento.

Stripe invia un evento webhook quando lo stato dell’addebito viene modificato. Quando si accetta una qualsiasi modalità di pagamento asincrona, la tua integrazione deve essere capace di ricevere webhook, in modo da poter ricevere questa notifica e la conferma dell’esito positivo o negativo del pagamento del cliente.