Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
AperçuMettre votre intégration à niveau
Paiements en ligne
PrésentationTrouver votre cas d'usage
Moyens de paiement
Payment interfaces
Payment scenarios
Paiements par TPE
Other Stripe products

Utiliser des codes promotionnelsBêta

Autorisez vos clients à saisir des codes promotionnels lors du paiement.

Version bêta privée

The Custom Checkout integration is in private preview. To request access, cliquez ici.

Créer un code promotionnel

Créez un code promotionnel en spécifiant un coupon existant ainsi qu’un code à communiquer à votre client.

Si vous ne fournissez pas de code, Stripe en génère un aléatoirement. Le code n’est pas sensible à la casse et est unique à l’échelle de tous les codes promotionnels actifs pour tous les clients.

Les codes promotionnels peuvent être créés dans la section des bons de réduction du Dashboard ou avec l’API :

Command Line
curl https://api.stripe.com/v1/promotion_codes \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d coupon={{COUPON_ID}} \
  -d code=VIPCODE

Activer des codes promotionnels

Activez les codes promotionnels utilisables par l’utilisateur en spécifiant le paramètre allow_promotion_codes lors de la création de la session Checkout.

server.ts
const session = await stripe.checkout.sessions.create({
  line_items: [
    {
      price_data: {
        currency: 'usd',
        product_data: {
          name: 'T-shirt',
        },
        unit_amount: 2000,
      },
      quantity: 1,
    },
  ],
  mode: 'payment',
  ui_mode: 'custom',
  return_url: '{{RETURN_URL}}',
  allow_promotion_codes: true,
});

Utiliser des codes promotionnels

Utilisez applyPromotionCode pour appliquer un code promotionnel saisi par votre client. Utilisez removePromotionCode pour supprimer tous les codes promotionnels précédemment appliqués.

PromotionCode.jsx
import React from 'react';
import {useCustomCheckout} from '@stripe/react-stripe-js';

const PromotionCode = () => {
  const {applyPromotionCode, removePromotionCode} = useCustomCheckout();
  const [draft, setDraft] = React.useState('');
  const [loading, setLoading] = React.useState(false);

  const handleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
    setDraft(e.target.value);
  };
  const handleSubmit = () => {
    setLoading(true);
    applyPromotionCode(draft).finally(() => {
      setDraft('');
      setLoading(false);
    });
  };
  const handleRemove = () => {
    removePromotionCode();
  };

  return (
    <div>
      <input type="text" value={draft} onChange={handleChange} />
      <button disabled={loading} onClick={handleSubmit}>
        Apply
      </button>
      <button onClick={handleRemove}>Remove</button>
    </div>
  );
};

export default PromotionCode;

Limiter l'utilisation

Vous pouvez limiter l’utilisation des codes promotionnels lors de leur création :

  • Spécifiez customer pour limiter l’utilisation à un client spécifique.
  • Spécifiez expires_at pour fixer la date limite d’utilisation du code promotionnel.
  • Spécifiez max_redemptions pour limiter le nombre de fois où le code promotionnel peut être utilisé.
  • Spécifiez restrictions.minimum_amount et restrictions.minimum_amount_currency pour définir le montant minimum requis pour utiliser ce code promotionnel (par exemple, un client doit faire un achat d’au moins 100 $ pour que le code soit valable).
Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications des produits.
Des questions ? Contactez l'équipe commerciale.
Propulsé par Markdoc
Sur cette page
Créer un code promotionnel
Activer des codes promotionnels
Utiliser des codes promotionnels
Limiter l'utilisation
Produits utilisés
Checkout
Elements