Paiements VippsVersion bêta privée

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 le paiement émis par un client et suit le cycle de vie du processus de paiement étape par étape. Pour commencer, créez un PaymentIntent sur votre serveur et précisez le montant à encaisser ainsi que la devise nok (la seule devise prise en charge par Vipps). Si vous avez déjà créé une intégration à l’aide de l’API Payment Intents, ajoutez vipps à la liste des types de moyens de paiement pour votre PaymentIntent.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "amount"=1099 \
  -d "currency"="nok" \
  -d "payment_method_types[]"="vipps" \
  -d "payment_method_data[type]"="vipps" \
  -d "payment_method_options[vipps][reference]"="ORDER_123"

Réponse

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "payment_method": "pm_12345",
  "payment_method_types": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "status": "requires_confirmation"
}

Utilisez l’id du PaymentIntent de l’étape 2 pour confirmer le PaymentIntent. Cette action indique que le client souhaite payer avec le PaymentMethod spécifié. Une fois le PaymentIntent confirmé, le paiement est déclenché. Le paramètre return_url détermine la page vers laquelle Stripe doit rediriger l’utilisateur après avoir procédé au paiement.

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

Réponse

{
  "id": "pi_12345",
  "amount": 1099,
  "currency": "nok",
  "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": [
     "vipps"
  ],
  "payment_method_options": {
    "vipps": {
      "reference": "ORDER_123",
    },
  },
  "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 Vipps sur laquelle le client peut saisir le numéro de téléphone associé à son compte Vipps. Il peut ensuite utiliser l’application mobile Vipps pour autoriser le paiement.

• Sur un appareil mobile, l’URL ouvre directement l’application Vipps (le cas échéant) ou la page d’accueil Vipps, de la même façon que sur un ordinateur de bureau.

Utilisez une méthode telle que les webhooks pour gérer le traitement de la commande. Lorsque votre client effectue le paiement, l’état du PaymentIntent passe à succeeded et le PaymentIntent envoie l’événement webhook payment_intent.succeeded. À défaut de paiement, le PaymentIntent envoie l’événement webhook payment_intent.payment_failed et repasse à l’état requires_payment_method.