Facturer la livraison

Créez différents tarifs de livraison pour vos clients.

Les frais de livraison vous permettent de proposer différentes options d’envoi (Standard, Express, 24 heures, etc.) avec des estimations de livraison plus précises. Vous pouvez facturer les frais de livraison à vos clients en utilisant les produits Stripe. Avant de créer des frais de livraison, découvrez comment recueillir les adresses de facturation et de livraison .

Remarque

Les tarifs d’expédition ne prennent en charge que des valeurs fixes pour l’ensemble de la commande. Vous ne pouvez pas ajuster les frais de livraison en fonction du nombre d’articles dans la commande.

Créer des frais de livraison
Côté serveur

Les frais de livraison ne prennent en charge que des valeurs de montant fixe pour l’ensemble de la commande. Vous ne pouvez pas ajuster les frais de livraison en fonction du nombre d’articles dans la commande.

Pour ajouter des frais de livraison à l’aide du Dashboard :

Cliquez sur Créer des frais de livraison.
Renseignez un montant, une description et, si vous le souhaitez, une estimation du délai de livraison.
Cliquez sur Enregistrer et copiez l’ID des frais de livraison (shr_123456).

Saisir les détails de vos frais de livraison

Modifier des frais de livraison

Vous ne pouvez pas mettre à jour les frais de livraison dans le Dashboard. Pour mettre à jour des frais de livraison dans le Dashboard, vous devez archiver les frais de livraison concernés, puis en créer d’autres.

Archiver les frais de livraison

Pour archiver des frais de livraison :

Dans l’onglet Frais de livraison, sélectionnez les frais de livraison applicables.
Cliquez sur le menu déroulant , puis sélectionnez Archiver.

Pour désarchiver les frais de livraison, cliquez sur le menu déroulant et sélectionnez Désarchiver les frais de livraison.

Créer une session Checkout
Côté serveur

Pour créer une session Checkout qui inclut vos frais de livraison, transmettez l’identifiant du tarif généré au paramètre shipping_options . Si vous souhaitez créer les frais de livraison en même temps qu’une session Checkout, utilisez le paramètre shipping_rate_data avec shipping_options. Seules les sessions Checkout en mode paiement prennent en charge les options de livraison.

L’exemple de code suivant ajoute deux options d’expédition à la session Checkout :

Livraison gratuite sous 5 à 7 jours ouvrables (estimation).
Livraison par voie aérienne sous 1 jour ouvré (estimation) pour un coût de 15,00 USD.

Collecter l'option de livraison choisie par le client
Côté client

Côté client, utilisez l’objet shippingOptions pour afficher les options de livraison disponibles, par exemple dans une liste de boutons radio. Lorsque votre client sélectionne une option de livraison, appelez updateShippingOption avec l’identifiant de l’option de livraison.

index.html
<div id="shipping-options"></div>

checkout.js
actions.getSession().shippingOptions.forEach((option) => {
  const form = document.createElement('form');

  shippingOptions.forEach(option => {
    const label = document.createElement('label');
    const radio = document.createElement('input');
    radio.type = 'radio';
    radio.id = option.id;
    radio.name = 'shippingOption';
    radio.value = option.id;
    radio.addEventListener('click', () => {
      actions.updateShippingOption(option.id)
    })

    const labelText = document.createTextNode(option.displayName);

    label.appendChild(radio);
    label.appendChild(labelText);
    form.appendChild(label);
  });

  document.getElementById('shipping-options').appendChild(form);
});
const shippingAddressElement = checkout.createShippingAddressElement();
shippingAddressElement.mount('#shipping-address');

FacultatifGérer les transactions réussies

Une fois le paiement aboutit, vous pouvez récupérer le montant de la livraison dans l’attribut amount_total de shipping_cost. Vous pouvez également récupérer le tarif de livraison sélectionné à l’aide de l’attribut shipping_rate de shipping_cost. Pour accéder à la propriété shipping_cost, vous devez créer un gestionnaire d’événements pour gérer les sessions Checkout terminées. Vous pouvez tester un gestionnaire en installant la CLI Stripe et en utilisant stripe listen --forward-to localhost:4242/webhook pour transférer les événements vers votre serveur local. Dans l’exemple de code suivant, le gestionnaire permet à l’utilisateur d’accéder à shipping_property :

FacultatifÉtablir une estimation du délai de livraison

Vous pouvez configurer des tarifs de livraison avec différentes combinaisons d’estimations du délai de livraison. Le tableau suivant présente des exemples d’estimations, avec leurs valeurs delivery_estimate.minimum et delivery_estimate.maximum correspondantes :

Estimation du délai de livraison	Minimum	Maximum
1 jour	`{ unit: 'day', value: 1, }`	`{ unit: 'day', value: 1, }`
1 jour ouvré	`{ unit: 'business_day', value: 1, }`	`{ unit: 'business_day', value: 1, }`
Au moins 2 jours ouvrés	`{ unit: 'business_day', value: 2, }`	`null`
3 à 7 jours	`{ unit: 'day', value: 3, }`	`{ unit: 'day', value: 7, }`
4 à 8 heures	`{ unit: 'hour', value: 4, }`	`{ unit: 'hour', value: 8, }`
De 4 heures à 2 jours ouvrés	`{ unit: 'hour', value: 4, }`	`{ unit: 'business_day', value: 2, }`

FacultatifAppliquer la taxe aux frais de livraison

Vous pouvez utiliser Stripe Tax pour calculer automatiquement la taxe appliquée aux frais de livraison en définissant un tax_code et un tax_behavior sur vos frais de livraison. Stripe Tax détermine automatiquement si la livraison est imposable (car la fiscalité varie selon l’état et le pays), puis applique le taux de taxe adapté si c’est le cas.

Lors de la création d’un tarif d’expédition avec shipping_rate_data ou par le biais de Create a Shipping Rate, vous pouvez ajouter un paramètre tax_behavior et tax_code au tarif d’expédition.

Nous vous recommandons de définir le tax_code sur Shipping (txcd_92010001) pour vous assurer que vous facturez toujours la juste taxe. Vous pouvez également définir le tax_code du tarif de livraison sur Nontaxable (txcd_00000000) si vous ne souhaitez facturer aucune taxe.

Dans cet exemple, nous définissons le tax_behavior sur exclusive (courant aux États-Unis). Pour plus d’informations, reportez-vous à notre documentation relative au comportement fiscal.