API SourcesObsoleto

Source objects allow you to accept a variety of payment methods with a single API. A source represents a customer’s payment method, and you can use it with the Stripe API to create payments. You can charge sources directly, or attach them to customers for later reuse.

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

You can enable any payment method available to you within the Dashboard. Activation is generally instantaneous, and doesn’t require additional contracts nor include a lengthy process. For a detailed listing, see the available payment methods and their supported geographical regions.

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.

• Using a pull method, you debit the funds from the customer’s account after the customer has provided consent. Card payments are an example of a pull method: your customer’s card is debited when a payment is made, and no customer interaction is required for subsequent debits.
• 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.

Reusable sources must be attached to a Customer to be reused. (If charged directly, their status will change to consumed.)

Conferma sincrona e asincrona

Dopo aver creato un oggetto Charge usando un metodo 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.