Collect consent for promotional emails
U.S. only

Learn how to collect permission from customers so that you can send them promotional emails.

Promotional emails are often sent to inform customers of new products and to share coupons and discounts. For example, you can use them to subscribe customers to company newsletters or send cart abandonment emails.

Collect consent from customers to send them promotional emails

To protect consumers from unwanted spam, customers must agree to receiving promotional emails before you can contact them. Checkout helps you collect the necessary consent, where applicable, to send promotional emails. See the FAQ for more details about promotional email requirements.

You can collect promotional email consent with Stripe Checkout when you create the session:

Command Line

curl https://api.stripe.com/v1/checkout/sessions \
  -u sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "payment_method_types[0]"=card \
  -d "line_items[0][price]"="{{PRICE_ID}}" \
  -d "line_items[0][quantity]"=2 \
  -d customer="{{CUSTOMER_ID}}" \
  -d mode=payment \
  -d success_url="https://example.com/success" \
  -d cancel_url="https://example.com/cancel" \
  -d "consent_collection[promotions]"="auto"

When consent_collection.promotions='auto', Checkout dynamically displays a checkbox for collecting the customer’s consent to promotional content.

When the checkbox is shown, the default state depends on the customer’s country and the country your business is based in. Data privacy laws vary by jurisdiction, so Checkout disables or limits this feature when local regulations prohibit it.

The Checkout Session’s consent attribute records whether or not the session collected promotional consent from the customer.

As customers complete purchases, keep track of which customers consent to promotional content. You can create or update an existing webhook handler to do this. Listen to the checkout.session.completed event, check for the consent.promotions status, and then store email addresses for customers who give consent.

// Find your endpoint's secret in your Dashboard's webhook settings
const endpointSecret = 'whsec_...';

// Using Express
const app = require('express')();

// Use body-parser to retrieve the raw body as a buffer
const bodyParser = require('body-parser');

const recordPromotionalEmailConsent = (email, promoConsent) => {
  // TODO: fill me in
  console.log("Recording promotional email consent", email, promoConsent);
}

app.post('/webhook', bodyParser.raw({type: 'application/json'}), (request, response) => {
  const payload = request.body;
  const sig = request.headers['stripe-signature'];

  let event;

  try {
    event = stripe.webhooks.constructEvent(payload, sig, endpointSecret);
  } catch (err) {
    return response.status(400).send(`Webhook Error: ${err.message}`);
  }

  // Handle the checkout.session.completed event
  if (event.type === 'checkout.session.completed') {
    const session = event.data.object;
    const promoConsent = session.consent?.promotions;
    const email = session.customer_details.email;

    // Record whether or not the customer has agreed to receive promotional emails
    recordPromotionalEmailConsent(email, promoConsent)

    // Handle order fulfillment
  }
  response.status(200);
});

Next steps

After you’ve configured Checkout to collect consent for sending customers promotional content, you can recover abandoned carts by following up with leads who left Checkout before completing payment.

Collect consent for promotional emailsU.S. only

Collect consent

Store consent and email address

Next steps

Collect consent for promotional emails
U.S. only