SoftSolzSoftSolz
Sign up
HomeAPI GuideAPI ReferenceWidget Tester
Stripe Payments

PATCHhttps://app.softsolz.uk/api/v1/services/payments/payment-links/{id}

Recent Requests

Kept only in this browser
TimeStatusTook
Send a request with Try it to see it here.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: Bearer sk_live_... (or sk_test_... for sandbox). A login token will not work here.

Idempotency-Keystring

Optional idempotency key for safe retries.

Body Params

activebooleanrequired

New enabled state: true enables, false disables. Required, and must be a boolean. This endpoint changes nothing else, and any other field is refused with 400.

expected_updated_atstring | null

Optimistic-concurrency guard from a prior read; if stale, returns 409 STALE_VERSION.

Response

Response Body

idintegerPayment link id.
tokenstringOpaque public token used in hosted-pay links and checkout-session creation.
kindstringSurface type. "button" embeds on a page; "link" is a shareable hosted link.
titlestringDisplay title / Stripe line-item name.
descriptionstring | nullOptional longer description.
amount_centsinteger | nullFixed charge amount in minor units, or null when the customer chooses the amount.
min_amount_centsinteger | nullMinimum allowed amount in minor units for custom-amount links; null when a fixed amount is set.
currencystringISO 4217 currency code, upper-cased.
activebooleanWhether the link can currently take payments.
show_business_namebooleanWhether the tenant business name is shown on the hosted page.
button_colorstring | nullHex button background colour, or null.
button_text_colorstring | nullHex button text colour, or null.
paid_countintegerNumber of successful payments recorded against this link.
created_atstringCreation timestamp.
updated_atstringLast-update timestamp; round-trip as expected_updated_at for optimistic concurrency on PATCH.

Request

curl --request PATCH \
  --url https://app.softsolz.uk/api/v1/services/payments/payment-links/{id} \
  --header 'Authorization: Bearer sk_live_your_key' \
  --header 'Content-Type: application/json' \
  --data '{
  "active": false
}'

Credentials

Sent as a Bearer token and used in the samples above and in Try it. Kept only in this browser tab until you close it. Use an sk_test_ key to stay in your sandbox.

Response · 200

{
  "data": {
    "id": 42,
    "token": "kQ8r3mZ7xv1nT0pL2bC9dE4f",
    "kind": "button",
    "title": "Premium plan",
    "description": "One-off onboarding charge",
    "amount_cents": 2500,
    "min_amount_cents": null,
    "currency": "GBP",
    "active": true,
    "show_business_name": false,
    "button_color": "#1d4ed8",
    "button_text_color": "#ffffff",
    "paid_count": 12,
    "created_at": "2026-05-01T09:00:00.000Z",
    "updated_at": "2026-05-02T10:30:00.000Z"
  }
}