Accéder directement au contenu
Créez un compte ou connecter-vous
Logo de la documentation Stripe
/
Créez un compteConnectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usageUtiliser Managed Payments
Paiements par TPE
Moyens de paiement
Scénarios de paiement
Au-delà des paiements

Accepter un paiement OXXO

Découvrez comment accepter les paiements effectués à l'aide de OXXO, un moyen de paiement très répandu au Mexique.

Mise en garde

Stripe peut automatiquement proposer les moyens de paiement pertinents à vos clients en évaluant la devise, les restrictions liées aux moyens de paiement et d’autres paramètres.

  • Suivez le guide Accepter un paiement pour créer une intégration de paiement qui utilise des moyens de paiement dynamiques.
  • Si vous ne souhaitez pas utiliser de moyens de paiement dynamiques, suivez les étapes ci-dessous pour configurer manuellement les moyens de paiement dans votre intégration Checkout.

OXXO est un moyen de paiement à usage unique qui implique pour le client quelques actions supplémentaires pour effectuer son paiement. Les clients procèdent au paiement en espèces dans un commerce de proximité OXXO en fournissant un coupon OXXO doté d’un numéro généré automatiquement.

Déterminer la compatibilité

Une session Checkout doit remplir toutes les conditions suivantes pour prendre en charge les paiements OXXO :

  • Les tarifs de tous les postes de facture doivent être exprimés dans la même devise. Pour définir des postes dans différentes devises, créez des sessions Checkout distinctes pour chacune d’entre elles.
  • Vous ne pouvez utiliser que des postes ponctuels (les postes récurrents dans le cadre de plans d’abonnement ne sont pas pris en charge).

Accepter un paiement

Remarque

Avant d’utiliser ce guide, commencez par créer une intégration permettant d’accepter un paiement avec Checkout.

Cela vous explique comment activer OXXO et vous montre les différences entre l’acceptation de paiements à l’aide de moyens de paiement dynamiques et la configuration manuelle des moyens de paiement.

Activer OXXO comme moyen de paiement

Lors de la création d’une nouvelle session Checkout, vous devez :

  1. Ajouter oxxo à la liste des payment_method_types.
  2. Veiller à ce que tous vos line_items utilisent la devise mxn.
Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

Options supplémentaires du moyen de paiement

Vous pouvez définir le paramètre facultatif expires_after_days dans les options du moyen de paiement de votre Session pour déterminer le nombre de jours calendaires avant expiration de votre coupon OXXO. Par exemple si vous créez un coupon OXXO un lundi en définissant le paramètre expires_after_days sur 2, le coupon OXXO expirera le mercredi suivant à 23 h 59, heure de la ville de Mexico (America/Mexico_City : UTC-6). La valeur du paramètre expires_after_days doit être comprise entre 1 et 7 jours. Par défaut, elle est de 3 jours.

Command Line
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "line_items[0][price_data][currency]"=mxn \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_options[oxxo][expires_after_days]"=2 \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=oxxo \
  --data-urlencode success_url="https://example.com/success"

Rediriger vers la page du coupon hébergée par Stripe

Une fois l’envoi du formulaire Checkout effectué, le client est redirigé vers la page hosted_voucher_url. Il accède au code-barres ou imprime le coupon OXXO depuis la page coupon hébergée. Le hosted_voucher_url est disponible dans payment_intent.next_action.oxxo_display_details.

Stripe vous permet de personnaliser les interfaces utilisateur sur la page Paramètres de marque. Vous pouvez appliquer les paramètres de marque suivants au coupon :

  • Icône : image représentant votre marque et votre dénomination sociale publique
  • Couleur secondaire : utilisée comme couleur du bouton d’impression
  • Couleur de marque : utilisée comme couleur d’arrière-plan

Traiter vos commandes

OXXO étant un moyen de paiement à notification différée, vous devez utiliser une méthode telle que des webhooks pour suivre l’état des paiements et gérer la réalisation des commandes. Découvrez-en plus sur la configuration des webhooks et la réalisation des commandes.

Les événements suivants sont envoyés lorsque l’état du paiement change :

Nom de l’événementDescriptionÉtapes suivantes

checkout.session.completed

Le client a envoyé le formulaire Checkout. Stripe a généré le coupon OXXO.

Vous pouvez choisir d’envoyer le hosted_voucher_url à votre client par e-mail au cas où il perdrait le coupon OXXO.

Attendez que le client s’acquitte du paiement du coupon OXXO.

checkout.session.async_payment_succeededLe client s’est acquitté du paiement du coupon OXXO. Le PaymentIntent bascule sur succeeded.Traitez la commande de biens ou de services du client.
checkout.session.async_payment_failedLe coupon OXXO a expiré, ou le paiement a échoué pour un autre motif. Le PaymentIntent revient à l’état requires_payment_method.Contactez le client par e-mail et demandez-lui de passer une nouvelle commande.

Tester votre intégration

Lors du test de votre intégration Checkout, sélectionnez le moyen de paiement OXXO, puis cliquez sur le bouton Payer.

Adresse e-mailDescription

{any_prefix}@{any_domain}

Simule un coupon OXXO réglé par le client au bout de 3 minutes et pour lequel le webhook payment_intent.succeeded arrive après environ 3 minutes. En mode production, ce webhook arrive au bout d’un jour ouvrable.

Exemple : fulano@test.com

{any_prefix}succeed_immediately@{any_domain}

Simule un coupon OXXO immédiatement réglé par le client et pour lequel le webhook payment_intent.succeeded arrive en quelques secondes. En mode production, ce webhook arrive au bout d’un jour ouvrable.

Exemple : succeed_immediately@test.com

{any_prefix}expire_immediately@{any_domain}

Simule un coupon OXXO qui expire avant le règlement du client et pour lequel le webhook payment_intent.payment_failed arrive en quelques secondes.

Le champ expires_after de next_action.oxxo_display_details est défini sur la date/heure du jour, quelle que soit la valeur du paramètre expires_after_days des options du moyen de paiement.

Exemple : expire_immediately@test.com

{any_prefix}expire_with_delay@{any_domain}

Simule un coupon OXXO qui expire avant le règlement du client et pour lequel le webhook payment_intent.payment_failed arrive au bout de 3 minutes environ.

Le champ expires_after de next_action.oxxo_display_details est défini sur 3 minutes plus tard, quelle que soit la valeur du paramètre expires_after_days des options du moyen de paiement.

Exemple : expire_with_delay@test.com

{any_prefix}fill_never@{any_domain}

Simule un coupon OXXO qui expire avant le règlement du client et pour lequel le webhook payment_intent.payment_failed arrive au bout d’un jour ouvré et de deux jours calendaires. En mode production, ce webhook arrive à la même vitesse qu’en mode test.

Exemple : fill_never@test.com

FacultatifEnvoyer des instructions sur les paiements par e-mail

Vous pouvez activer l’envoi d’instructions sur les paiements OXXO et de rappels par e-mail sur la page Paramètres des e-mails sur le Dashboard. Une fois activé, Stripe enverra par e-mail des instructions sur les paiements dès le PaymentIntent confirmé. Les e-mails contiennent le numéro OXXO et un lien vers la page coupon hébergée par Stripe.

Remarque

Dans les environnements de test, seules les adresses e-mail associées au compte Stripe reçoivent des instructions par e-mail.

Voir aussi