Salvare il metodo di pagamento di un cliente senza effettuare un pagamento

Innanzitutto crea un account Stripe o accedi.

Utilizza le nostre librerie ufficiali per accedere all’API Stripe dalla tua applicazione:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Per configurare una modalità di pagamento per pagamenti futuri, è necessario associarla a un Customer. Crea un oggetto Customer quando il cliente crea un account con la tua azienda. Gli oggetti Customer permettono di riutilizzare le modalità di pagamento e di monitorare più pagamenti.

curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Crea una sessione di completamento della transazione conmode=setup.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d mode=setup \
  -d ui_mode=custom \
  -d currency=usd

Se non hai creato la sessione di completamento della transazione con un cliente esistente, utilizza l’ID del PaymentMethod per associare il metodo pagamento a un cliente.

In caso contrario, il metodo di pagamento si collega automaticamente al cliente indicato durante la creazione della sessione di completamento della transazione.

curl https://api.stripe.com/v1/payment_methods/
{{PAYMENT_METHOD_ID}}
/attach \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}"

Dopo che un cliente ha completato con successo la sessione di completamento della transazione, gestisci il webhook checkout.session.completed. Recupera l’oggetto Session nel webhook e quindi effettua le seguenti operazioni:

• Ottieni il valore della chiave setup_intent, che è l’ID SetupIntent creato durante la sessione di completamento della transazione.
• Utilizza l’ID SetupIntent per recuperare l’oggetto SetupIntent. L’oggetto restituito contiene un ID payment_method che puoi collegare a un cliente nel passaggio successivo.

Ulteriori informazioni sull’impostazione dei webhook.

Dopo aver collegato il metodo di pagamento a un cliente, è possibile effettuare un pagamento off-session utilizzando unPaymentIntent:

• Imposta customer con l’ID cliente e payment_method con l’ID del metodo di pagamento.
• Impostare off_session a true per indicare che il cliente non è nel flusso di pagamento durante un tentativo di pagamento e non può soddisfare una richiesta di autenticazione effettuata da un partner, come una società emittente della carta, una banca o altro istituto di pagamento. Se, durante il flusso di pagamento, un partner richiede l’autenticazione, Stripe richiede le esenzioni utilizzando le informazioni sul cliente ricavate da una transazione precedente on-session. Se le condizioni per l’esenzione non sono soddisfatte, PaymentIntent potrebbe generare un errore.
• Imposta il valore di conferma della proprietà PaymentIntent atrue, per far sì che la conferma avvenga immediatamente quando crei il PaymentIntent.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=usd \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d payment_method=
"{{PAYMENT_METHOD_ID}}" \
  -d off_session=true \
  -d confirm=true

Se un tentativo di pagamento non riesce, non riesce anche la richiesta con un codice di stato HTTP 402 e il PaymentIntent stato è requires_payment_method. Avvisa il cliente di tornare all’applicazione (ad esempio, inviando un’email o una notifica in-app) e indirizza il tuo cliente a una nuova sessione di completamento della transazione per selezionare un altro metodo di pagamento.

curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
"{{CUSTOMER_ID}}" \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=1099 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d ui_mode=custom \
  --data-urlencode return_url="https://example.com/return"