Bloccare un metodi di pagamento

Quando crei un pagamento, puoi bloccare un metodo di pagamento idoneo per trattenere dei fondi che potrai acquisire in seguito. Ad esempio, gli hotel spesso autorizzano un pagamento completo prima dell’arrivo dell’ospite, quindi acquisiscono il denaro quando l’ospite lascia l’albergo al termine del soggiorno. Questa operazione viene talvolta definita acquisizione manuale.

L’autorizzazione di un pagamento garantisce l’importo trattenendolo sul metodo di pagamento del cliente. Se utilizzi l’API, l’attributo payment_method_details.card.capture_before dell’addebito indica la scadenza dell’autorizzazione.

Devi acquisire i fondi prima della scadenza dell’autorizzazione. Se l’autorizzazione scade prima dell’acquisizione dei fondi, questi vengono rilasciati e lo stato del pagamento passa a canceled. Ulteriori informazioni sugli stati dei pagamenti asincroni.

Finestre di validità dell’autorizzazione

Le tabelle seguenti illustrano le finestre di validità per l’autorizzazione di diversi tipi di transazioni.

Transazioni con carta non presente

Transazioni con carta presente (pagamenti di persona)

Finestre di autorizzazione di 30 giorni in Giappone

Se il tuo account è domiciliato in Giappone, puoi conservare le transazioni in JPY di Visa, Mastercard, JCB, Diners Club e Discover per un massimo di 30 giorni. Le transazioni non in JPY e American Express scadono dopo la finestra standard di 7 giorni.

Limitazioni dei metodi di pagamento

Prima di passare all’implementazione, tieni presente che la separazione tra autorizzazione e acquisizione è soggetta alle seguenti limitazioni.

• Solo alcuni metodi di pagamento accettano l’autorizzazione e l’acquisizione del pagamento separati. Alcuni metodi di pagamento che supportano questa funzionalità includono carte, Affirm, Afterpay, Cash App Pay, Klarna e PayPal. Alcuni metodi di pagamento che non supportano questa funzionalità includono ACH e iDEAL. Scopri di più sul supporto delle funzioni dei metodi di pagamento.

• Oltre a quanto illustrato nelle tabelle precedenti, altri metodi di pagamento hanno regole e finestre di autorizzazione diverse:

  • Pagamenti con carta: in genere l’importo viene trattenuto per 7 giorni per i pagamenti online e per 2 giorni per i pagamenti di persona effettuati con Terminal (a seconda del tipo di transazione e del circuito della carta). Puoi richiedere un’autorizzazione estesa per determinate autorizzazioni di pagamento online e Terminal idonee per periodi di validità estesi. I circuiti delle carte di credito potrebbero limitare anche le autorizzazioni a 1 USD che non intendi acquisire.
  • Affirm: se Affirm richiede un acconto per ordini molto elevati, addebita l’importo in fase di autorizzazione e lo rimborsa se il pagamento non viene acquisito. Hai quindi 30 giorni di tempo per acquisire il saldo del pagamento.
  • Afterpay/Clearpay: Durante l’autorizzazione, il cliente paga la prima rata di rimborso. Afterpay rimborsa il pagamento se non viene mai acquisito. Hai quindi 13 giorni di tempo per addebitare il saldo di pagamento.
  • Cash App Pay: Per completare un pagamento, le autorizzazioni valide devono essere acquisite entro 7 giorni.
  • Klarna: L’addebito deve essere effettuato entro la mezzanotte del ventottesimo giorno di calendario successivo alla richiesta, altrimenti l’autorizzazione scadrà. Ad esempio, dovrai acquisire una richiesta di addebito alle 14:00 del 01/10/2020 entro le 00:00 UTC del 29/10/2020.
  • PayPal: Trattiene l’importo per 10 giorni. Stripe tenta automaticamente di estendere la trattenuta per altri 10 giorni, per un totale di 20 giorni. La tua preferenza di regolamento potrebbe influire sul periodo di autorizzazione. Per ulteriori informazioni, consulta la sezione relativa all’autorizzazione e all’acquisizione separate.

Utilizzare la Dashboard per autorizzare e acquisire

Puoi autorizzare un pagamento e acquisire fondi separatamente senza scrivere codice.

1. Nella Dashboard, crea un nuovo pagamento. Seleziona Una tantum.
2. Quando inserisci o selezioni il metodo di pagamento, seleziona Altre opzioni e Acquisisci i fondi in seguito.

Il pagamento viene mostrato nella tua pagina di pagamento come Non acquisito.

Per acquisire i fondi, vai alla pagina dei dati di pagamento e fai clic su Acquisisci.

Indicare a Stripe di eseguire solo l’autorizzazione

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price]"=
{{PRICE_ID}} \
  -d "line_items[0][quantity]"=2 \
  -d mode=payment \
  -d ui_mode=custom \
  -d "payment_intent_data[capture_method]"=manual

Acquisire i fondi

Dopo l’autorizzazione del metodo di pagamento, lo stato del PaymentIntent diventa requires_capture. Per acquisire i fondi autorizzati, effettua una richiesta di acquisizione del PaymentIntent. L’importo totale autorizzato viene acquisito per impostazione predefinita. Per acquisire un importo inferiore o superiore a quello iniziale per alcuni pagamenti online con carta, specifica l’opzione amount_to_capture. Un’acquisizione parziale sblocca automaticamente l’importo rimanente. Se tenti di acquisire un importo superiore a quello iniziale per un pagamento con carta online, consulta la documentazione sulle acquisizioni di importo superiore.

L’esempio seguente mostra come acquisire 7,50 USD di un pagamento autorizzato pari a 10,99 USD:

curl https://api.stripe.com/v1/payment_intents/pi_123/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=750

Sebbene alcuni pagamenti con carta siano idonei per l’acquisizione multipla, per la maggior parte dei pagamenti puoi eseguire solo un’acquisizione su un pagamento autorizzato. Se acquisisci parzialmente un pagamento, non puoi eseguire un’altra acquisizione per la differenza. A seconda delle tue esigenze, potrebbe essere consigliabile salvare i dati del metodo di pagamento del cliente per utilizzarli in seguito e creare pagamenti futuri in base alle necessità.

Gli estratti conto della carta di alcune società emittenti e le interfacce dei metodi di pagamento non fanno differenza tra autorizzazioni e pagamenti acquisiti (saldati), il che talvolta può confondere i clienti.

Inoltre, quando un cliente completa la procedura di pagamento su un PaymentIntent con acquisizione manuale, attiva l’evento payment_intent.amount_capturable_updated. Puoi controllare la proprietà amount_capturable del PaymentIntent per visualizzare l’importo totale che puoi acquisire dal PaymentIntent.

Annullare l’autorizzazione

Per annullare un’autorizzazione, puoi annullare il PaymentIntent.

Acquisisci il pagamento prima della scadenza dell’autorizzazione Public preview

Puoi impostare Stripe in modo che acquisisca automaticamente i pagamenti prima della scadenza dell’autorizzazione, invece di attivare manualmente l’acquisizione per i metodi di pagamento con carta. Utilizza l’acquisizione automatica ritardata per assicurarti di non perdere i pagamenti autorizzati. Puoi anche specificare un periodo di ritardo personalizzato tra l’autorizzazione e l’acquisizione.

Per abilitare l’acquisizione automatica ritardata, imposta capture_method su automatic_delayed in PaymentIntent:

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d "payment_method_options[card][capture_method]"=automatic_delayed

Con questo approccio, Stripe acquisisce il pagamento con carta prima della scadenza dell’autorizzazione, attivando l’acquisizione circa 6 ore prima della scadenza. Questo serve come processo di backup per garantire che i pagamenti autorizzati vengano acquisiti prima della scadenza. È comunque possibile acquisire o annullare manualmente il PaymentIntent prima che venga acquisito automaticamente.

Puoi specificare un periodo di ritardo personalizzato per l’acquisizione includendo il parametro capture_delay_days. Questo parametro indica il numero di giorni di ritardo dell’acquisizione dopo l’autorizzazione riuscita:

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d "payment_method_types[]"=card \
  -d "payment_method_options[card][capture_method]"=automatic_delayed \
  -d "payment_method_options[card][capture_delay_days]"=3

In questo esempio, Stripe acquisisce automaticamente il PaymentIntent 3 giorni dopo l’autorizzazione. Ciò è utile se conosci il tempo necessario per eseguire le azioni tra l’autorizzazione e l’acquisizione, garantendo al contempo l’acquisizione prima della scadenza dell’autorizzazione.