Percevoir des taxes pour les paiements récurrents

curl https://api.stripe.com/v1/invoices/create_preview \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_tax[enabled]"=true \
  -d "customer_details[tax][ip_address]"={{IP_ADDRESS}} \
  -d "subscription_details[items][0][price]"=
{{PRICE_ID}}

Vérifiez le automatic_tax.status de la facture. S’il affiche requires_location_inputs, cela signifie que les coordonnées de l’adresse ne sont pas valides ou sont insuffisantes. Dans ce cas, invitez votre client à saisir à nouveau ses coordonnées ou à fournir des coordonnées exactes.

Le total de la facture correspond au montant payé par votre client, et la taxe correspond à la somme de tous les montants des taxes figurant sur la facture. Pour obtenir le détail des taxes, reportez-vous à la section total_tax_amounts. Tous les montants sont en cents.

Une fois que vous avez estimé les taxes et le montant total, commencez à collecter les informations relatives au client, notamment son adresse de livraison (le cas échéant), son adresse de facturation et ses informations de paiement. Notez que lorsque vous utilisez Stripe Tax, vous collectez des informations de paiement sans Intent. La première étape consiste à créer un objet Elements sans Intent :

const stripe = Stripe(
"pk_test_TYooMQauvdEDq54NiTphI7jx");

const elements = stripe.elements({
  mode: 'subscription',
  currency: '{{CURRENCY}}',
  amount: 
{{TOTAL}},
});

Ensuite, créez un Address Element et un Payment Element et montez-les :

const addressElement = elements.create('address', {
  mode: 'billing' // or 'shipping', if you are shipping goods
});
addressElement.mount('#address-element');

const paymentElementOptions = { layout: 'accordion'};
const paymentElement = elements.create('payment', paymentElementOptions);
paymentElement.mount('#payment-element');

Ensuite, vous pouvez écouter change events sur l’Address Element. En cas de modification de l’adresse, réestimez les taxes et le montant total.

addressElement.on('change', function(event) {
  // Throttle your requests to avoid overloading your server or hitting
  // Stripe's rate limits.
  const { tax, total } = await updateEstimate(event.value.address);

  elements.update({ amount: total });
  // Update your page to display the new tax and total to the user...
});

Lorsque votre client envoie le formulaire, appelez elements.submit() pour valider les champs du formulaire et collecter toutes les données requises pour les wallets. Vous devez attendre que la promesse de cette fonction soit résolue avant d’effectuer toute autre opération.

document.querySelector("#form").addEventListener("submit", function(event) {
  // We don't want to let default form submission happen here,
  // which would refresh the page.
  event.preventDefault();

  const { error: submitError } = await elements.submit();
  if (submitError) {
    // Handle error...
    return;
  }

  const { value: customerDetails } = await addressElement.getValue();

  // See the "Save customer details" section below to implement this
  // server-side.
  await 
saveCustomerDetails(customerDetails);

  // See the "Create subscription" section below to implement this server-side.
  const { 
clientSecret
 } = await 
createSubscription();

  const { error: confirmError } = await stripe.confirmPayment({
    elements,
    clientSecret,
    confirmParams: {
      return_url: 
{{RETURN_URL}},
    },
  });
  if (confirmError) {
    // Handle error...
    return;
  }

  // Upon a successful confirmation, your user will be redirected to the
  // return_url you provide before the Promise ever resolves.
});

Modifiez votre objet Customer à l’aide des informations que vous avez recueillies auprès de votre client. Stripe Tax pourra ainsi déterminer son emplacement précis et obtenir des résultats précis.

Si vous n’avez pas encore créé d’objet Customer (par exemple, lorsque votre client s’inscrit pour la première fois sur votre site Web), vous pouvez en créer un maintenant.

curl https://api.stripe.com/v1/customers/
{{CUSTOMER_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "address[line1]"={{LINE1}} \
  -d "address[line2]"={{LINE2}} \
  -d "address[city]"={{CITY}} \
  -d "address[state]"={{STATE}} \
  -d "address[postal_code]"={{POSTAL_CODE}} \
  -d "address[country]"={{COUNTRY}} \
  -d "tax[validate_location]"=immediately

La valeur tax.validate_location enum vous permet de vérifier que l’emplacement fiscal du client devient (ou reste) valide à la suite de cette opération. Dans le cas contraire, Stripe refuse la requête et renvoie le code d’erreur customer_tax_location_invalid. Cela est important, car vous ne pouvez pas créer d’abonnement automatique pour les taxes pour un client dont l’emplacement fiscal n’est pas valide. Si vous avez vérifié le automatic_tax.status dans l’aperçu de vos factures comme indiqué précédemment, cette validation supplémentaire n’échouera jamais. Cependant, il est recommandé de définir tax[validate_location]="immediately" chaque fois que vous créez ou modifiez un objet Customer.

Créez un abonnement pour lequel la taxe automatique est activée.

curl https://api.stripe.com/v1/subscriptions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "automatic_tax[enabled]"=true \
  -d customer=
{{CUSTOMER_ID}} \
  -d "items[0][price]"=
{{PRICE_ID}} \
  -d "payment_settings[save_default_payment_method]"=on_subscription \
  -d "expand[0]"="latest_invoice.confirmation_secret"

The latest_invoice.confirmation_secret.client_secret is the client secret of the payment intent of the first (and the latest) invoice of the new subscription. You need to pass the client secret to your front end to be able to confirm the payment intent.

Si votre client dispose d’un moyen de paiement par défaut, la première facture de l’abonnement est payée automatiquement. Vous pouvez le vérifier à l’aide du latest_invoice.status de l’abonnement. Si vous souhaitez utiliser les nouvelles informations de paiement collectées auprès de votre client dans votre flux de paiement, vérifiez que la première facture n’est pas payée automatiquement. Transmettez default_incomplete pour le payment_behavior lors de la création de votre abonnement et confirmez l’intention de paiement à l’aide de stripe.confirmPayment(), comme indiqué. Consultez la page Méthodes de recouvrement de la facturation pour en savoir plus.