---
title: "Update Payment Link"
method: PATCH
path: "/v1/payment_links/{id}"
tags: ["Payment Links"]
---

# Update Payment Link

`PATCH /v1/payment_links/{id}`

Updates an existing payment link. Only the supplied fields are changed; omitted fields are
left unchanged. The mutable fields are `label`, `after_completion`, and `active` — line items,
discounts, and other parameters are fixed once the link is created. Set `active` to `false` to
archive the link, which removes it from list results and makes checkout session generation
from the link return a 404. Set `active` back to `true` to restore it.

## Path parameters

- `id` string, required

## Request body

- PaymentLinkBodyForUpdatePaymentLinkRequest — An envelope wrapping a single payment link object.
  - `payment_link` UpdatePaymentLinkRequest, required — Parameters for updating a payment link. Only the supplied fields are changed; omitted fields are left unchanged.
    - `label` string, nullable — Custom name shown for the payment link. Omit to leave the current label unchanged.
    - `after_completion` AfterCompletion — Configures what the customer sees after completing a checkout session generated from a payment link.
      - `type` 'redirect' | 'hosted_confirmation', required — What happens after a payment link checkout completes: a redirect to your URL, or a Flex-hosted confirmation page.
      - `hosted_confirmation` HostedConfirmation — Hosted confirmation page shown after a completed checkout when `after_completion.type` is `hosted_confirmation`.
        - `custom_message` string, nullable — A custom message displayed to the customer on the hosted confirmation page.
      - `redirect` Redirect — Redirect behavior applied after a completed checkout when `after_completion.type` is `redirect`.
        - `url` string, uri, required — The URL the customer is redirected to after completing the checkout.
    - `active` boolean, nullable — Set to false to archive this payment link. Inactive payment links are hidden from list views by default.

## Response `200`

An envelope wrapping a single payment link object.

- PaymentLinkBodyForPaymentLink — An envelope wrapping a single payment link object.
  - `payment_link` PaymentLink, required — A Payment Link represents a shareable URL that generates a checkout session each time a customer opens it. Use it to sell products or collect a payment method without building your own checkout page.
    - `payment_link_id` string, required — Unique identifier for the Payment Link
    - `label` string, nullable — Provided or generated label for the payment link.
    - `active` boolean, required — Whether the payment link is currently active. If false, the link can no longer be used to generate checkout sessions and customers visiting the URL will be shown a not-found page.
    - `line_items` NewLineItem[], nullable — The line items representing what is being sold.
      - `price` string, nullable — The ID of the Price object. One of price or price_data is required.
      - `price_data` NewPriceRequest — Parameters for creating a price. Reference an existing product with `product`, or create one inline with `product_data`.
        - `description` string, nullable — A brief description of the price.
        - `unit_amount` integer, required — A positive integer in cents (or 0 for a free price) representing how much to charge.
        - `recurring` Recurring — Describes how a recurring price bills over time. Present on prices of type `recurring`; `null` for one-time prices.
          - `interval` 'day' | 'week' | 'month' | 'year', required — The frequency at which a recurring price bills.
          - `interval_count` integer, nullable — The number of intervals
          - `trial_period_days` integer, nullable — The number of trial period days before the customer is charged for the first time. Whole days only. For a precise trial-end timestamp (e.g. non-integer days), use `subscription_data.trial_end` on the Create Checkout Session request instead.
        - `metadata` object, nullable — Metadata to attach to the price.
        - `product` string — The ID of the product that this price will belong to.
        - `product_data` CreateProductRequest — Parameters for creating a product. HSA/FSA eligibility is determined automatically by Flex from the name, description, and identifiers you provide, and cannot be set directly.
          - `name` string, required — The product's name, meant to be displayed to the customer.
          - `description` string, nullable — The product's description, a short blurb meant to be displayed to the customer.
          - `upc_code` string, nullable — The product's UPC code. If provided, this will be used to check whether the product is on the eligible product list.
          - `gtin` string, nullable — The product's GTIN. If provided, this will be used to check whether the product is on the eligible product list.
          - `reference_gtin` string, nullable — If the product is HSA/FSA eligible through private label, this should be provided.
          - `url` string, nullable — A URL of a publicly-accessible image of the product.
          - `client_reference_id` string, nullable — An optional identifier for the product set by the client. Immutable after creation.
          - `metadata` object, nullable — Set of key-value pairs that you can attach to a product. This can be useful for storing additional information about the product in a structured format.
          - `image_urls` string[], nullable — URLs of publicly-accessible product images for eligibility determination.
          - `categories` string[], nullable — Product categories (e.g., "Vitamins", "First Aid").
          - `components` string[], nullable — Product components or ingredients (e.g., "Vitamin C", "Zinc").
      - `quantity` integer, required — The quantity of the line item being purchased.
      - `shipping_options` ShippingRateOptionsRequest — Specifies the shipping rate to apply, either by referencing an existing rate or by providing inline data to create one. Provide one of `shipping_rate_id` or `shipping_rate_data`; at least one is required.
        - `shipping_rate_id` string, nullable — ID of an existing shipping rate to apply. Provide this or `shipping_rate_data`.
        - `shipping_rate_data` CreateShippingRateRequest — Parameters for creating a shipping rate.
          - `display_name` string, required — The name shown to the customer at checkout (e.g., `Standard Shipping`). Must be at least 2 characters.
          - `amount` integer, required — The shipping cost, in the smallest currency unit (e.g., `500` = $5.00 USD). Charged in USD.
          - `metadata` object, nullable — Set of key-value pairs you can attach to the shipping rate for storing additional structured information.
      - `tax_rate` TaxRate — A fixed tax amount to apply to a Checkout Session or line item. Use this to pass a tax figure you have calculated yourself, rather than having Flex compute it.
        - `amount` integer, required — The tax amount to apply, in the smallest currency unit (e.g., `175` = $1.75 USD).
    - `allow_promotion_codes` boolean, required — Whether promo codes are enabled
    - `shipping_address_collection` boolean, required — Whether we want to collect shipping details at checkout time
    - `shipping_options` ShippingRateOptions — A resolved shipping option attached to a checkout session or payment link, capturing the applied shipping rate and its cost.
      - `shipping_rate_id` string, required — ID of the applied shipping rate.
      - `shipping_amount` integer, required — The shipping cost, in the smallest currency unit (e.g., `500` = $5.00 USD). Charged in USD.
      - `display_name` string, nullable — The display name of the shipping rate (e.g., "Standard Shipping", "Express").
    - `metadata` object, nullable — Metadata to attach to the payment session
    - `url` string, required — The public URL that can be shared with customers.
    - `created_at` string, required — A timestamp encoded as an RFC 3339 / ISO 8601 string (e.g. `2026-06-15T14:30:00Z`).
    - `payment_intent_data` PaymentIntentData — Indicates the parameters to be passed to PaymentIntent creation during checkout
      - `capture_method` 'automatic' | 'automatic_async' | 'manual', required — Controls when funds are captured: automatically once the payment is confirmed, or manually at a later time.
      - `metadata` object, nullable — Set of key-value pairs attached to the PaymentIntent created during checkout, for storing additional structured information.
    - `after_completion` AfterCompletion, required — Configures what the customer sees after completing a checkout session generated from a payment link.
      - `type` 'redirect' | 'hosted_confirmation', required — What happens after a payment link checkout completes: a redirect to your URL, or a Flex-hosted confirmation page.
      - `hosted_confirmation` HostedConfirmation — Hosted confirmation page shown after a completed checkout when `after_completion.type` is `hosted_confirmation`.
        - `custom_message` string, nullable — A custom message displayed to the customer on the hosted confirmation page.
      - `redirect` Redirect — Redirect behavior applied after a completed checkout when `after_completion.type` is `redirect`.
        - `url` string, uri, required — The URL the customer is redirected to after completing the checkout.
    - `origin` 'shopify' | 'shopline' | 'prepurchase' | 'postpurchase' — Origin of where the checkout session was generated
    - `tax_rate` TaxRate — A fixed tax amount to apply to a Checkout Session or line item. Use this to pass a tax figure you have calculated yourself, rather than having Flex compute it.
      - `amount` integer, required — The tax amount to apply, in the smallest currency unit (e.g., `175` = $1.75 USD).
    - `discounts` string[], nullable — Pre-stored coupon IDs to apply as discounts when generating checkout sessions
    - `setup_future_use` 'on_session' | 'off_session', required — - `on_session`: Standard payments requiring customer auth - `off_session`: Allows payments without the customer present in the flow
    - `test_mode` boolean, required — Whether the payment link was created in test mode

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Validation Error
- `429` — Too Many Requests

---

[API](https://skmtc.dev/withflex/apis/flex-api.md) · [All operations](https://skmtc.dev/withflex/apis/flex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withflex/flex-api/revisions/b1560fc2f199/schema)