Accepter un paiement OXXO

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).

Suivez ce guide pour savoir comment activer OXXO et découvrir les différences entre l’acceptation d’un paiement par carte bancaire et l’utilisation de OXXO.

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.

Stripe::Checkout::Session.create({
  mode: 'payment',
  payment_method_types: ['card'],
  payment_method_types: ['card', 'oxxo'],
  # The parameter is optional. The default value of expires_after_days is 3.
  payment_method_options: {
    oxxo: {
      expires_after_days: 2
    }
  },
  line_items: [{
    price_data: {
      # To accept `oxxo`, all line items must have currency: mxn
      currency: 'mxn',
      product_data: {
        name: 'T-shirt',
      },
      unit_amount: 2000,
    },
    quantity: 1,
  }],
  success_url: 'https://example.com/success',
  cancel_url: 'https://example.com/cancel',
})

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.

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 :

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