Utiliser Adaptive Pricing avec Connect

Adaptive Pricing est toujours activé pour Payment Links. Gérez Adaptive Pricing pour vos comptes connectés sur Checkout dans vos paramètres Connect du Dashboard. Vous pouvez activer Adaptive Pricing dans un environnement de test ou en mode production. La désactivation d’Adaptive Pricing n’affecte pas les sessions Checkout qui ont déjà été converties.

La fonctionnalité Adaptive Pricing peut augmenter l’utilisation des moyens de paiement locaux en permettant aux clients de payer dans leur devise et avec leurs moyens de paiement habituels. À titre d’exemple, 70 % des transactions d’e-commerce effectuées aux Pays-Bas utilisent iDEAL, mais ce moyen de paiement ne fonctionne qu’en EUR. Vous pouvez configurer les moyens de paiement que vous acceptez dans les paramètres des moyens de paiement si vous utilisez des moyens de paiement dynamiques. Adaptive Pricing débloque l’accès aux moyens de paiement suivants, qui nécessitent une présentation dans la devise locale :

• Bancontact
• EPS
• iDEAL
• Link
• P24

La session Checkout et les objets PaymentIntent sous-jacents tiennent compte de la devise et du montant de votre intégration.

Si un client paie dans sa devise locale, l’événement checkout.session.completed contient un hachage presentment_details qui inclut presentment_amount et presentment_currency. Le montant et la devise reflètent la somme payée par votre client dans la devise locale.

{
  "id": 
'{{EVENT_ID}}',
  "object": "event",
  "type": "checkout.session.completed",
  "data": {
    "object": {
      "id": 
'{{SESSION_ID}}',
      "object": "checkout.session",
      "currency": "usd",
      "amount_total": 1000,
      "amount_subtotal": 1000,
      "presentment_details": {
        "presentment_amount": 1370,
        "presentment_currency": "cad"
      }
    }
  }
}

Pour tester la présentation en devise locale pour Checkout et Payment Links, transmettez l’adresse e-mail en précisant le pays du client au moyen d’un suffixe au format +location_XX dans la partie dédiée de l’e-mail. XX doit être un code pays ISO à deux lettres valide.

Par exemple, pour tester la devise présentée à un client français, transmettez une adresse e-mail de type test+location_FR@example.com.

La devise que vous voyez quand vous utilisez l’URL d’une session Checkout ou d’un lien de paiement créée à l’aide d’une adresse e-mail précisant le pays du client est identique à celle qui est présentée à un client du pays en question.

Test de Checkout

Lorsque vous créez une session Checkout, transmettez l’adresse e-mail précisant le pays du client dans le champ customer_email pour simuler un paiement à partir d’un pays particulier.

curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -d "line_items[0][price]"="{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  --data-urlencode customer_email="test+location_FR@example.com"

Vous pouvez également créer un objet Customer et indiquer son adresse e-mail en y ajoutant un suffixe de type +location_XX. Les cartes de test Stripe fonctionnent comme d’habitude.

Test de Payment Links

Pour Payment Links, transmettez une adresse e-mail précisant le pays du client dans le paramètre d’URL prefilled_email afin de tester les devises présentées aux clients de différents pays.

Adaptive Pricing n’est pas disponible pour les entreprises qui utilisent Elements avec l’API Payment Intents.

En outre, Adaptive Pricing exige que votre devise d’intégration soit la devise de règlement du marchand officiel associé au paiement.

Adaptive Pricing ne s’applique pas aux sessions Checkout :

• Contenant des tarifs manuels de devises explicitement définis.
• en mode subscription.
• Utilisant le paramètre capture_method défini sur manual.
• Utilisez des montants personnalisés.

Les sessions Checkout qui ne sont pas prises en charge par Adaptive Pricing présentent les tarifs dans leur devise d’origine.