Updates a payment link

Request

PATCH {{baseURL}}/v2/payment-links/{{paymentLinkId}}

This endpoint updates a payment link.

paymentMethods is replaced wholesale when present. A type absent from the new array stops being accepted. An entry without the processorId is pinned to the merchant's current default active processor of that type.

This endpoint returns the full updated payment link.

See Also:
To list payment links, see GET /v2/payment-links.
To retrieve a payment link by identifier, see GET /v2/payment-links/{{paymentLinkId}}.
To delete a payment link, see DELETE /v2/payment-links/{{paymentLinkId}}.
To share a payment link, see POST /v2/payment-links/{{paymentLinkId}}/share.

Security

Bearer

Path

paymentLinkIdstring, (uuid)required

Specifies the payment link identifier.

Example:6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b

Bodyapplication/json

Specifies fields that should be changed, remain the same, or deleted.

This endpoint is a partial update.

Send only the fields needed to be changed.
An omitted field is left unchanged.
A field marked as null clears a field.

Nested structures are also affected.

paymentMethodsobject

Identifies the payment methods a payment link accepts. It is keyed by method so each one carries only the configuration that applies to it.

baseAmountnumber or null, (double)

Specifies the payment amount (in USD).

This value must be greater than zero when provided. An explicit null clears the amount to a flexible amount, where the customer enters the amount at checkout.

Example: 25

Example:25

currencyCodestring or null

Specifies the transaction's currency code (in uppercase ISO 4217 currency code).

This value cannot be cleared, and the currency is frozen once the link has received payments.

Example: USD

Example:"USD"

linkTypestring

Identifies the payment link type.

Valid values are:

Type	Description
MultiUse	The link can be shared with, and paid by, more than one customer.
SingleUse	The link is intended for a single customer and a single payment.

Example: SingleUse

Default:"SingleUse"

Enum:"MultiUse""SingleUse"

Example:"SingleUse"

paymentLinkStatusstring

Indicates the status of the payment link.

Valid values are:

Status	Description
Active	The link is open and can accept a payment.
Completed	A SingleUse link that has received its one payment.
Expired	The link's `expiresOn` date has passed.
Inactive	The link was deactivated and cannot accept a payment.

Example: Active

Enum:"Active""Completed""Expired""Inactive"

Example:"Active"

customerIdstring or null, (uuid)

Specifies the customer the link is issued for.

An explicit null detaches the customer. This value is not allowed once the link is MultiUse.

referenceIdstring or null

Specifies a reference identifier provided by the merchant, up to 200 characters.

An explicit null clears this value.

Example: ORDER-1042

Example:"ORDER-1042"

namestring or null

Specifies the merchant-facing label for the payment link, up to 80 characters.

This value cannot be cleared.

Example: Spring campaign

Example:"Spring campaign"

descriptionstring or null

Specifies merchant-internal notes for the payment link, up to 500 characters.

An explicit null clears this value.

expiresOnstring or null, (date-time)

Specifies the UTC expiration date-time (in an ISO 8601 UTC date-time format).

This value must be a future date. An explicit null means the link never expires.

curl -i -X PATCH \
  https://sandbox.api.flute.com/v2/payment-links/6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Spring campaign (extended)",
    "expiresOn": "2026-10-15T00:00:00.000Z"
  }'

Responses

Bodyapplication/json

paymentLinkIdstring, (uuid)

Indicates the payment link identifier.

Example: 6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b

Example:"6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b"

linkTypestring

Identifies the payment link type.

Valid values are:

Type	Description
MultiUse	The link can be shared with, and paid by, more than one customer.
SingleUse	The link is intended for a single customer and a single payment.

Example: SingleUse

Default:"SingleUse"

Enum:"MultiUse""SingleUse"

Example:"SingleUse"

paymentMethodsobject

Identifies the payment methods a payment link accepts. It is keyed by method so each one carries only the configuration that applies to it.

baseAmountnumber or null, (double)

Indicates the payment amount.

If omitted or null, indicates the customer can enter the amount at checkout.

Example: 25

Example:25

currencyCodestring or null

Indicates the transaction's currency code (in uppercase ISO 4217 currency code).

Example: USD

Example:"USD"

paymentLinkStatusstring

Indicates the status of the payment link.

Valid values are:

Status	Description
Active	The link is open and can accept a payment.
Completed	A SingleUse link that has received its one payment.
Expired	The link's `expiresOn` date has passed.
Inactive	The link was deactivated and cannot accept a payment.

Example: Active

Enum:"Active""Completed""Expired""Inactive"

Example:"Active"

namestring or null, <= 80 characters

Indicates the merchant-facing label for the payment link.

Example: Spring campaign

Example:"Spring campaign"

descriptionstring or null

Indicates the merchant-internal notes for the payment link.

This value is never shown to customers.

Example: Shared with returning customers only

Example:"Shared with returning customers only"

shortUrlstring or null

Indicates the customer-facing shortened URL of the payment link.

Example: https://pay.example.com/l/abc123

Example:"https://pay.example.com/l/abc123"

customerIdstring or null, (uuid)

Indicates the customer the link is issued for.

If omitted or null, this value is for an anonymous link.

Example: a3b37f26-3b4c-4d5e-6f7a-8b9c0d1e2f58

Example:"a3b37f26-3b4c-4d5e-6f7a-8b9c0d1e2f58"

customerFirstNamestring or null

Indicates the first name of the attached customer, when any.

Example: Alexandro

Example:"Alexandro"

customerLastNamestring or null

Indicates the last name of the attached customer, when any.

Example: Peppared

Example:"Peppared"

referenceIdstring or null

Indicates the reference identifier provided by the merchant.

Example: ORDER-1042

Example:"ORDER-1042"

expiresOnstring or null, (date-time)

Indicates the UTC expiration date-time (in an ISO 8601 UTC date-time format).

This value is null when the link never expires.

Example: 2026-09-15T00:00:00.000Z

Example:"2026-09-15T00:00:00.000Z"

paymentCountinteger, (int32)

Indicates the number of successful payments received.

Example: 3

Example:3

totalCollectedAmountnumber, (double)

Indicates the sum of all successful payment amounts (in USD).

Example: 75

Example:75

createdOnstring, (date-time)

Indicates the date-time (in an ISO 8601 UTC date-time format) the payment link was created on.

Example: 2026-01-15T10:30:56.264Z

Example:"2026-01-15T10:30:56.264Z"

lastPaymentOnstring or null, (date-time)

Indicates the date-time (in an ISO 8601 UTC date-time format) of the newest successful payment.

This value is null when no payments exist.

Example: 2026-03-10T18:42:11.264Z

Example:"2026-03-10T18:42:11.264Z"

modifiedOnstring, (date-time)

Indicates the date-time (in an ISO 8601 UTC date-time format) the payment link was last modified on.

Example: 2026-07-07T14:09:31.264Z

Example:"2026-07-07T14:09:31.264Z"

Response

{
  "paymentLinkId": "6f2a8b3c-9d4e-4f1a-8b7c-3e5d6a9f0c1b",
  "linkType": "SingleUse",
  "paymentMethods": {
    "card": {
      "enabled": true,
      "processorId": "d529945e-8d10-4cb4-9dc3-718e57f3f14e"
    },
    "ach": {
      "enabled": true,
      "processorId": "d529945e-8d10-4cb4-9dc3-718e57f3f14e"
    }
  },
  "baseAmount": 25,
  "currencyCode": "USD",
  "paymentLinkStatus": "Active",
  "name": "Spring campaign",
  "description": "Shared with returning customers only",
  "shortUrl": "https://pay.example.com/l/abc123",
  "customerId": "a3b37f26-3b4c-4d5e-6f7a-8b9c0d1e2f58",
  "customerFirstName": "Alexandro",
  "customerLastName": "Peppared",
  "referenceId": "ORDER-1042",
  "expiresOn": "2026-09-15T00:00:00.000Z",
  "paymentCount": 3,
  "totalCollectedAmount": 75,
  "createdOn": "2026-01-15T10:30:56.264Z",
  "lastPaymentOn": "2026-03-10T18:42:11.264Z",
  "modifiedOn": "2026-07-07T14:09:31.264Z"
}