Paiements MobilePay

Utilisez nos bibliothèques officielles pour accéder à l’API Stripe depuis votre application :

# Available as a gem
sudo gem install stripe

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

Un PaymentIntent est un objet qui représente votre intention d’encaisser un paiement auprès d’un client et qui suit le cycle de vie du processus de paiement étape par étape. Créez un PaymentIntent sur votre serveur et spécifiez le montant à collecter ainsi qu’une devise prise en charge (eur, dkk, sek ou nok). Si votre intégration inclut déjà l’API Payment Intents, ajoutez mobilepay à la liste des types de moyens de paiement.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=dkk \
  -d "payment_method_types[]"=mobilepay \
  -d "payment_method_data[type]"=mobilepay

Exemple de réponse

{
  "id": "pi_12345",
  "amount": 1099,
  "client_secret": "pi_12345_secret_abcdef",
  "currency": "dkk",
  "payment_method": "pm_12345",
  "payment_method_types": [
     "mobilepay"
  ],
  "status": "requires_confirmation"
}

Récupérer la clé secrète du client

Le PaymentIntent contient une clé secrète à utiliser côté client pour finaliser le processus de paiement en toute sécurité. Vous pouvez adopter différentes approches pour transmettre cette clé secrète côté client.

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
})();

Utilisez l’ID de PaymentIntent de l’étape 2 pour confirmer le PaymentIntent. Cette action indique que le client souhaite payer avec le PaymentMethod spécifié. Stripe initie un paiement après confirmation du PaymentIntent. L’adresse return_url indique à Stripe où rediriger le client une fois le paiement effectué.

curl https://api.stripe.com/v1/payment_intents/
{{PAYMENT_INTENT_ID}}
/confirm \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  --data-urlencode return_url="https://example.com/checkout/complete"

Exemple de réponse

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "dkk",
  "payment_method": "pm_12345",
  "next_action": {
    "redirect_to_url": {
      "return_url": "https://example.com/checkout/complete",
      "url": "https://pm-redirects.stripe.com/authorize/acct_123/pa_nonce_abc"
    },
    "type": "redirect_to_url"
  },
  "payment_method_types": [
     "mobilepay"
  ],
  "status": "requires_action"
}

Pour autoriser le paiement, redirigez votre client vers l’URL spécifiée dans le champ next_action[redirect_to_url][url].

• Sur un ordinateur de bureau, l’URL ouvre une page d’accueil MobilePay sur laquelle le client peut saisir le numéro de téléphone associé à son compte MobilePay. Il peut ensuite utiliser l’application mobile MobilePay pour autoriser le paiement.
• Sur un appareil mobile, l’URL ouvre directement l’application MobilePay (le cas échéant) ou redirige vers la page d’accueil MobilePay, de la même façon que sur un ordinateur de bureau.

Votre client dispose de 5 minutes pour ouvrir l’URL de redirection et autoriser le paiement dans l’application MobilePay. Si le paiement par carte sous-jacent échoue, votre client peut choisir une autre carte et réessayer dans l’application MobilePay. Si le paiement n’est pas autorisé dans les 5 minutes, le paiement échoue et l’état du PaymentIntent passe à requires_payment_method.

Stripe envoie un événement payment_intent.succeeded à l’issue du paiement. Utilisez le Dashboard, un webhook personnalisé ou une solution partenaire pour recevoir ces événements et exécuter des actions, comme envoyer une confirmation de commande par e-mail à votre client, enregistrer la vente dans une base de données ou lancer un workflow de livraison.

Plutôt que d’attendre un rappel de votre client, écoutez ces événements. En effet, côté client, l’acheteur pourrait fermer la fenêtre de son navigateur ou quitter l’application avant l’exécution du rappel. Des personnes malveillantes peuvent en profiter pour manipuler la réponse. Si vous configurez votre intégration de manière à écouter les événements asynchrones, cela vous permettra également d’accepter de nouveaux moyens de paiement plus facilement à l’avenir. Apprenez-en davantage sur les différences entre les différents moyens de paiement pris en charge.

• Gérer les événements manuellement dans le Dashboard

  Utilisez le Dashboard pour afficher vos paiements de test dans le Dashboard, envoyer des reçus par e-mail, gérer les virements ou réessayer les paiements échoués.

• Créer un webhook personnalisé

  Créez un gestionnaire de webhook personnalisé pour écouter les événements et créer des tunnels de paiement asynchrones personnalisés. Testez et déboguez votre intégration de webhook localement avec la CLI Stripe.

• Intégrer une application prédéfinie

  Gérez les événements commerciaux courants, tels que l’automatisation ou le marketing et les ventes, en intégrant une application partenaire.

À l’aide de vos clés API de test, créez un PaymentIntent. Après avoir confirmé le PaymentIntent, suivez l’URL de redirection next_action qui vous mènera vers une page de test avec des options permettant de valider ou non le paiement.

• Cliquez sur Autoriser le paiement test pour tester le cas où le paiement a réussi. Le PaymentIntent passe de requires_action à succeeded.
• Cliquez sur Faire échouer le paiement test pour tester l’échec de l’authentification du client. Le PaymentIntent passe de requires_action à requires_payment_method.