Accettare un pagamento Afterpay o Clearpay

Innanzitutto, devi creare un account Stripe. Registrati ora.

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'

Un PaymentIntent è un oggetto che rappresenta la tua intenzione di riscuotere un pagamento da un cliente e traccia il ciclo di vita del processo di pagamento in ogni sua fase. Innanzitutto crea un PaymentIntent sul tuo server e specifica l’importo da riscuotere e la valuta. Se hai già un’integrazione che utilizza l’API Payment Intents, aggiungi afterpay_clearpay all’elenco dei tipi di metodi di pagamento per il tuo PaymentIntent.

Puoi gestire i metodi di pagamento dalla Dashboard. Stripe determina il reindirizzamento ai metodi di pagamento idonei in base a fattori quali l’importo della transazione, la valuta e il flusso di pagamento. Nell’esempio che segue viene utilizzato l’attributo automatic_payment_methods, ma puoi elencare afterpay_clearpay con i tipi di metodi di pagamento. Nell’ultima versione dell’API, specificare il parametro automatic_payment_methods è facoltativo perché Stripe ne abilita la funzionalità per impostazione predefinita. Indipendentemente dall’opzione scelta, assicurati di abilitare Afterpay Clearpay nella Dashboard.

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 "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="1234 Main Street" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"=CA \
  -d "shipping[address][country]"=US \
  -d "shipping[address][postal_code]"=94111

Recuperare la chiave privata client

L’oggetto PaymentIntent contiene una chiave privata client, che il lato client usa per completare la procedura di pagamento in modo sicuro. Per specificare la chiave privata sul lato client, puoi utilizzare approcci diversi.

get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Altre opzioni delle modalità di pagamento

Puoi specificare un parametro reference facoltativo nelle opzioni dei metodi di pagamento per il tuo PaymentIntent che imposta un identificativo interno dell’ordine per il pagamento. Sebbene queste informazioni non siano generalmente visibili né all’attività né al cliente, il team di assistenza interno di Afterpay può accedervi durante le richieste di assistenza manuali. L’identificatore ha un limite di 128 caratteri e può contenere solo lettere, cifre, caratteri di sottolineatura, barre rovesciate e trattini.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=1099 \
  -d "currency"="usd" \
  -d "payment_method_types[]"="afterpay_clearpay" \
  // Shipping address is optional but recommended to pass in.
  -d "shipping[name]"="Jenny Rosen" \
  -d "shipping[address][line1]"="1234 Main Street" \
  -d "shipping[address][city]"="San Francisco" \
  -d "shipping[address][state]"="CA" \
  -d "shipping[address][country]"="US" \
  -d "shipping[address][postal_code]"=94111 \
  -d "payment_method_options[afterpay_clearpay][reference]"="order_123"

In questo passaggio, completi i pagamenti Afterpay sul client con Stripe.js.

Configurare Stripe.js

Quando un cliente fa clic per pagare con Afterpay, ti consigliamo di utilizzare Stripe.js per inviare il pagamento a Stripe. Stripe.js è la nostra libreria JavaScript di base per creare i flussi di pagamento. Gestisce automaticamente le operazioni complesse, come il reindirizzamento descritto di seguito. Inoltre ti consente di estendere facilmente la tua integrazione ad altre modalità di pagamento in futuro. Per includere lo script di Stripe.js nella tua pagina di pagamenti, aggiungilo nell’intestazione del file HTML.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>

Crea un’istanza di Stripe.js con il seguente JavaScript nella pagina di pagamento:

// Set your publishable key: remember to change this to your live publishable key in production
// See your keys here: https://dashboard.stripe.com/apikeys
var stripe = Stripe(
  
'pk_test_TYooMQauvdEDq54NiTphI7jx',
);

Anziché inviare tutto l’oggetto PaymentIntent al client, utilizza la chiave privata client del passaggio 2. Questa chiave è diversa dalle chiavi API che eseguono l’autenticazione delle richieste API Stripe.

Gestisci la chiave privata client con attenzione in quanto può effettuare l’addebito. Non devi registrarla, inserirla negli URL né mostrarla a nessuno se non al cliente.

Utilizza stripe.confirmAfterpayClearpayPayment per gestire il reindirizzamento dalla tua pagina e completare il pagamento. Aggiungi un return_url a questa funzione per specificare dove Stripe deve reindirizzare l’utente dopo il completamento del pagamento sull’applicazione mobile o il sito web di Afterpay.

// Redirects away from the client
const {error} = await stripe.confirmAfterpayClearpayPayment(
  '{{PAYMENT_INTENT_CLIENT_SECRET}}',
  {
    payment_method: {
      billing_details: {
        email: 'jenny@rosen.com',
        name: 'Jenny Rosen',
        address: {
          line1: '1234 Main Street',
          city: 'San Francisco',
          state: 'CA',
          country: 'US',
          postal_code: '94111',
        },
      },
    },
    return_url: 'https://example.com/checkout/complete',
  }
);
if (error) {
  // Inform the customer that there was an error.
}

Quando il cliente invia un pagamento, Stripe lo reindirizza al return_url e include i seguenti parametri di ricerca dell’URL. La pagina di ritorno può utilizzarli per ottenere lo stato del PaymentIntent in modo da poter mostrare lo stato del pagamento al cliente.

Quando specifichi il parametro return_url, puoi anche aggiungere i tuoi parametri di ricerca da utilizzare nella pagina di ritorno.

Quando il cliente viene reindirizzato al tuo sito, puoi utilizzare il payment_intent_client_secret per eseguire una query per il PaymentIntent e mostrare al cliente lo stato della transazione.