Migrare all'API Payment Intents

Un’integrazione creata con Stripe.js ed Elements consiste delle seguenti fasi:

1. Registrare l’intenzione di incassare il pagamento sul lato server
2. Raccogliere i dati di pagamento sul lato client
3. Avviare la creazione del pagamento
4. Evadere l’ordine del cliente sul lato server

Fase 1: registrare l’intenzione di incassare il pagamento sul lato server

Crea un PaymentIntent sul tuo server e rendilo accessibile sul lato client.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "currency"="usd"

Fase 2: raccogliere i dati di pagamento sul lato client

Utilizza la funzione confirmCardPayment, che raccoglie i dati di pagamento e li invia direttamente a Stripe.

stripe.createToken(
  cardElement
).then(function(token) {
  // Send token to server
});

stripe.confirmCardPayment(
  INTENT_SECRET_FROM_STEP_1,
  {
    payment_method: {card: cardElement}
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The payment has succeeded
    // Display a success message
  }
});

Fase 3: avviare la creazione del pagamento

Nella tua integrazione esistente, la fase finale consiste nell’utilizzare le informazioni di pagamento tokenizzate per creare un addebito sul server. Questo non è più necessario perché la funzione confirmCardPayment richiamata nella fase precedente avvia la creazione dell’addebito.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{FROM_PREVIOUS_STEP}}" \
  -d "amount"=1099 \
  -d "currency"="usd"

Fase 4: evadere l’ordine del cliente

Con la conferma automatica, l’addebito viene creato in modo asincrono in base alle azioni del cliente sul lato client; devi quindi monitorare i webhook per sapere quando il pagamento viene completato correttamente. Per eseguire operazioni come l’evasione degli ordini dopo che il pagamento di un cliente è andato a buon fine, implementa il supporto per i webhook e monitora l’evento payment_intent.succeeded.

Ora che hai effettuato la migrazione, utilizza le carte di test della sezione seguente per verificare che la tua integrazione aggiornata gestisca l’autenticazione 3D Secure.

Un’integrazione dell’API Payment Intents che raccoglie i dati delle carte nel flusso di pagamento consiste delle seguenti fasi:

1. Registrare l’intenzione di incassare il pagamento sul lato server
2. Raccogliere i dati di pagamento sul lato client
3. Avviare la creazione del pagamento
4. Evadere l’ordine del cliente sul lato server

Fase 1: registrare l’intenzione di incassare il pagamento sul lato server

Crea un PaymentIntent sul tuo server. Imposta setup_future_usage su off_session se intendi addebitare i pagamenti agli utenti principalmente quando sono scollegati dalla tua applicazione o su on_session se prevedi di effettuare gli addebiti quando sono collegati all’applicazione. Se intendi utilizzare la carta sia per i pagamenti all’interno che all’esterno della sessione, usa off_session. Se specifichi il parametro setup_future_usage insieme a un ID cliente, il PaymentMethod risultante verrà salvato per questo cliente dopo che il PaymentIntent è stato confermato e che il cliente ha effettuato tutte le azioni richieste. Infine, rendi il PaymentIntent accessibile sul lato client.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "setup_future_usage"="off_session" \
  -d "amount"=1099 \
  -d "currency"="usd"

Fase 2: raccogliere i dati di pagamento sul lato client

Utilizza la funzione confirmCardPayment, che raccoglie i dati di pagamento e li invia direttamente a Stripe.

stripe.createToken(
// or stripe.createSource
  cardElement
).then(function(token) {
  // Send token to server
});

stripe.confirmCardPayment(
  '{{INTENT_SECRET_FROM_STEP_1}}',
  {
    payment_method: {card: cardElement},
  }
).then(function(result) {
  if (result.error) {
    // Display error.message in your UI.
  } else {
    // The payment has succeeded
    // Display a success message
  }
});

Infine, associa la modalità di pagamento (paymentIntent.payment_method) al cliente.

curl https://api.stripe.com/v1/customers/{{CUSTOMER_ID}}/sources \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{TOKEN_OR_SOURCE}}"

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

Fase 3: avviare la creazione del pagamento

Nella tua integrazione esistente, la fase finale consiste nell’utilizzare le informazioni di pagamento tokenizzate per creare un addebito sul server. Questo non è più necessario perché la funzione confirmCardPayment richiamata nella fase precedente avvia la creazione dell’addebito.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "source"="{{FROM_PREVIOUS_STEP}}" \
  -d "customer"="{{CUSTOMER_ID}}" \
  -d "amount"=1099 \
  -d "currency"="usd"

Fase 4: evadere l’ordine del cliente

Con la conferma automatica, l’addebito viene creato in modo asincrono in base alle azioni del cliente sul lato client; devi quindi monitorare i webhook per sapere quando il pagamento viene completato correttamente. Per eseguire operazioni come l’evasione degli ordini dopo che il pagamento di un cliente è andato a buon fine, implementa il supporto per i webhook e monitora l’evento payment_intent.succeeded.

Ora che hai effettuato la migrazione, utilizza le carte di test della sezione seguente per verificare che la tua integrazione aggiornata gestisca l’autenticazione 3D Secure.