Adaptive Pricing

Adaptive Pricing est toujours activé pour Payment Links. Gérez Adaptive Pricing pour Checkout dans vos paramètres de paiement 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

Adaptive Pricing peut affecter certaines parties de votre intégration, comme les destinations d’événements et la création de rapports. Vérifiez votre intégration pour vous assurer que toutes les destinations d’événements peuvent traiter les objets PaymentIntent en devises locales.

• Utilisez la devise et le montant total de l’objet CheckoutSession pour déterminer ce que votre client a payé dans votre devise de votre intégration, qui est celle que vous avez indiquée pour vos tarifs.
• Utilisez le hachage presentment_details sur l’objet Checkout Session pour déterminer ce que votre client a payé dans sa devise locale.

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.

De plus, Adaptive Pricing exige que la devise de vos tarifs soit l’une de vos devises de règlement. Les tarifs sont automatiquement convertis au moment du paiement. Ce comportement s’applique aux tarifs que vous créez et référencez avec un ID de tarif, ainsi qu’aux tarifs créés en série avec le paramètre price_data à la création d’une session Checkout.

Si vous traitez des paiements via une plateforme, nous exigeons que la devise d’intégration de votre plateforme 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.