Confronto tra l'API Charges e l'API Payment Intents
Differenze tra le due API di pagamento principali di Stripe e informazioni su quando utilizzarle
Come funzionano le API Stripe per i pagamenti
Attualmente Stripe consente di accettare i pagamenti in tre modi:
- Stripe Checkout
- API Charges
- API Payment Intents
Stripe Checkout è una pagina di pagamento predefinita a cui puoi reindirizzare il cliente per acquisti e abbonamenti semplici. Offre molte funzionalità, come Apple Pay, Google Pay, internazionalizzazione e convalida moduli.
Le API Charges e Payment Intents ti permettono di creare flussi ed esperienze di pagamento personalizzati.
Payment Intents è l’API che accomuna tutti i prodotti e le modalità di pagamento Stripe. L’API Charges non diventerà obsoleta, ma le nuove funzionalità saranno disponibili solo con l’API Payment Intents.
Per un confronto completo delle funzionalità, vedi la tabella seguente:
| API Charges | API Payment Intents |
|---|---|
| Utilizzata dalle aziende con clienti principalmente negli Stati Uniti e in Canada che desiderano un modo semplice per accettare le carte. | Richiesta per le aziende che accettano più modalità di pagamento e carte che richiedono l’autenticazione (ad esempio. l’autenticazione forte del cliente (SCA) in Europa). |
| Funziona su Web, iOS e Android. | Funziona su Web, iOS e Android. Può essere utilizzata anche per accettare pagamenti in negozio con Terminal. |
| Supporta le carte e tutti i metodi di pagamento nell’API Sources. | Supporta carte, carte che richiedono 3DS, iDEAL, SEPA e molti altri metodi di pagamento. |
| Non è compatibile con la SCA | È compatibile con la SCA |
Migrare il codice che legge dagli addebiti
Se la tua applicazione ha più flussi di pagamento che intendi migrare in modo incrementale dall’API Charges all’Payment Intents API, devi prima aggiornare il codice che legge dall’oggetto Charge. A tale scopo, l’oggetto Charge presenta due proprietà aggiuntive, payment_method_details e billing_details, che forniscono un’interfaccia coerente per la lettura dei dettagli del metodo di pagamento utilizzato per l’addebito.
Questi campi sono disponibili in tutte le versioni API e negli oggetti Charge creati sia con l’API Charges sia con l’API Payment Intents.
La tabella seguente indica le proprietà comunemente utilizzate in un addebito e come accedere alle stesse informazioni utilizzando le proprietà aggiuntive: