Stripe Payment Link update endpoint accepts setup_future_usage

Introduced 2026-07-29 · score 0.91

HOW TO USE IT

When updating an existing Payment Link, set `payment_intent_data.setup_future_usage` to `on_session` or `off_session` to indicate the intended reuse of the payment method collected during Checkout.

curl https://api.stripe.com/v1/payment_links/<PAYMENT_LINK_ID> \
  -u "<YOUR_SECRET_KEY>:" \
  -H "Stripe-Version: 2026-07-29.dahlia" \
  -d "payment_intent_data[setup_future_usage]=off_session"

WHY THIS HELPS

Set future payment method reuse behavior when updating an existing Payment Link.

BEFORE THIS CHANGE

Requests including `payment_intent_data.setup_future_usage` returned a 400 error before this change.

REQUIREMENTS AND LIMITATIONS

payment_intent_data: Subset of parameters passed to PaymentIntent creation for Checkout Sessions in `payment` mode.
payment_intent_data.setup_future_usage: Set to `on_session` or `off_session` to indicate intended reuse of the payment method collected during Checkout. The future usage docs recommend `off_session` when payments may occur both on and off session.
Prerequisite: A Payment Link ID and Stripe secret key are needed for the documented update request. This API parameter applies to Checkout Sessions in `payment` mode.
The value indicates how the payment method collected during the Checkout Session is intended to be reused.

FIRST-PARTY EVIDENCE

Check the installed version and the source before using it. Entry JSON

Report a problem with this card

Tools change faster than your agent’s training data.

Changes

Stripe Payment Link update endpoint accepts setup_future_usage