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

Per indicare che vuoi separare l’autorizzazione dall’acquisizione, imposta capture_method su manual quando crei il PaymentIntent. Il parametro indica a Stripe di limitarsi ad autorizzare l’importo senza acquisirlo con il metodo di pagamento del cliente.

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

Con l’approccio sopra descritto, indichi a Stripe che puoi usare “capture after” solo per un PaymentIntent con metodi di pagamento idonei. Ad esempio, non puoi accettare pagamenti con carta e addebito diretto SEPA (che non supporta l’acquisizione successiva) per un singolo PaymentIntent. Per accettare i metodi di pagamento che potrebbero non essere tutti compatibili con l’addebito successivo, puoi configurare capture-after-per-payment-method configurando capture_method=manual nell’oggetto payment_method_options[<payment_method_type>].

Ad esempio, se configuri payment_method_options[card][capture_method]=manual, metti in sospeso solo i pagamenti con carta. Puoi gestire i metodi di pagamento dalla Dashboard. Stripe gestisce la logica che consente di visualizzare dinamicamente i metodi di pagamento idonei più pertinenti per ogni cliente, in base a fattori quali l’importo della transazione, la valuta e il flusso di pagamento.

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

In alternativa, puoi indicare card e sepa_debit utilizzando i tipi di metodo di pagamento, come nell’esempio riportato di seguito.

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

Prima di passare all’acquisizione, associa un metodo di pagamento con i dati della carta al PaymentIntent e autorizza la carta confermando il PaymentIntent. Puoi eseguire questa operazione impostando i campi payment_method e confirm del PaymentIntent.

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.