API Payment Methods

L’API Payment Methods ti consente da sola di accettare una serie di modalità di pagamento. Un oggetto PaymentMethod contiene i dettagli delle modalità di pagamento che permettono di creare i pagamenti. Con l’API Payment Methods, puoi combinare un oggetto PaymentMethod:

• Con un PaymentIntent per accettare un pagamento
• Con un SetupIntent e Customer per salvare i dettagli di un pagamento e riutilizzarli in seguito

Modalità di pagamento supportate

Per determinare quali modalità di pagamento utilizzare per ogni area geografica, consulta la guida alle modalità di pagamento.

Questa guida include i metodi di pagamento disponibili nelle varie aree geografiche, una descrizione dettagliata delle caratteristiche di ciascuna di esse e le aree geografiche in cui sono più pertinenti. Puoi attivare tutti i metodi di pagamento disponibili per te nella Dashboard. Di norma questa attivazione è istantanea e non richiede contratti supplementari.

Azioni del cliente

​​Alcune modalità di pagamento prevedono che il cliente esegua ulteriori passaggi per completare l’acquisto. Il parametro next_action dell’oggetto PaymentIntent specifica il tipo di azione del cliente.

Ecco alcune delle azioni più frequenti che devono eseguire:

• Autenticarsi e approvare il pagamento dopo il reindirizzamento al servizio online della propria banca.
• Confermare di avere effettivamente la proprietà dell’account fornendo un codice una tantum che pubblichi nell’API Stripe (ad esempio, microdepositi).
• Inviare fondi (ad esempio, in caso di trasferimenti bancari) attraverso il servizio online della propria banca.

Non tutte le modalità di pagamento richiedono ulteriori azioni da parte del cliente. Ad esempio, i pagamenti con carta (ad eccezione di 3D Secure) non richiedono un’autenticazione aggiuntiva oltre alla raccolta dei dati della carta.

Notifica immediata o differita della riuscita del pagamento

Alcune modalità di pagamento restituiscono immediatamente uno stato di pagamento quando viene effettuato un tentativo di transazione (ad esempio, i pagamenti con carta), mentre altre posticipano questa notifica (ad esempio, gli addebiti ACH). Per le modalità di pagamento che restituiscono immediatamente uno stato di pagamento, lo stato dell’oggetto PaymentIntent passa a succeeded o requires_payment_method. Lo stato succeeded garantisce che riceverai i fondi dai clienti.

Le modalità di pagamento con notifica differita non possono garantire il pagamento durante il periodo che precede la notifica. Lo stato dell’oggetto PaymentIntent è processing finché il pagamento non è riuscito o non riuscito. Spesso le aziende bloccano un ordine nello stato in sospeso durante questo periodo e procedono all’evasione solo dopo che il pagamento è andato a buon fine.

Modalità di pagamento monouso o riutilizzabili

Puoi riutilizzare determinate modalità di pagamento (come le carte o gli addebiti bancari) per altri pagamenti senza autorizzare e raccogliere di nuovo i dati di pagamento.

Dovresti sempre impostare modalità di pagamento riutilizzabili per usi futuri per ridurre la possibilità di rifiuti e le difficoltà di pagamento (come la richiesta di autenticazione). Le modalità di pagamento riutilizzabili possono essere configurate per usi futuri quando si accetta un pagamento o configurate per usi futuri senza accettare un pagamento.

Le modalità di pagamento monouso (come alcuni tipi di bonifico bancario) non possono essere associate ai clienti perché vengono utilizzate dopo un tentativo di pagamento.

Utilizzare i webhook per monitorare lo stato dei pagamenti

Per configurare i webhook, crea un endpoint del webhook o un altro tipo di destinazione dell’evento per i metodi di pagamento che richiedono l’azione del cliente o che hanno la notifica di pagamento posticipata. Stripe invia i seguenti eventi quando lo stato PaymentIntent viene aggiornato:

Puoi anche utilizzare le seguenti opzioni anziché configurare una destinazione dell’evento per ascoltare gli eventi:

• Monitora manualmente lo stato dei pagamenti nella Dashboard Stripe se la tua azienda accetta un numero ridotto di ordini associati alle modalità di pagamento con notifica differita. Nella Dashboard puoi visualizzare tutti i tuoi pagamenti Stripe, inviare ricevute via email, gestire i pagamenti o ritentare i pagamenti non riusciti.
• Utilizza il polling, che consiste nel recuperare ripetutamente un PaymentIntent in modo da controllarne lo stato. Tuttavia, questa tecnica è decisamente meno affidabile e potrebbe presentare problemi se utilizzata su larga scala. Stripe applica limiti di velocità alle richieste API, pertanto ti consigliamo di prestare attenzione se utilizzi il polling.
• Utilizza un’applicazione partner per gestire gli eventi aziendali consueti, come automazione o marketing e vendite.

L’oggetto PaymentMethod

Un PaymentMethod contiene i dettagli delle modalità di pagamento riutilizzabili per la creazione di pagamenti (come l’indirizzo di fatturazione o la data di scadenza della carta), ma non include le informazioni specifiche di una transazione (come l’importo e la valuta). Un PaymentMethod è associato a un PaymentIntent per rappresentare gli stati del ciclo di vita di un pagamento. Ogni PaymentMethod ha un attributo Type (ad esempio "type": "sepa_debit" ) e un hash supplementare il cui nome corrisponde al tipo e contiene informazioni specifiche sul tipo di PaymentMethod (ad esempio "sepa_debit":{}). Esempio di un oggetto PaymentMethod sepa_debit:

{
  "id": "pm_123456789",
  "object": "payment_method",
  "billing_details": {
    "address": {...},
    "email": "jenny@example.com",
    "name": "Jenny Rosen",
    "phone": "+335555555555"
  },
  "sepa_debit": {
    "bank_code": "37040044",
    "branch_code": "94832",
    "country": "FR",
    "fingerprint": "ygEJfUjzWMGyWnZg",
    "last4": "3000"
  },
  "type": "sepa_debit",
  (...)
}