Update a link
Change a link's details or price, or archive it to stop taking payments.
Send only what changes. Archive a link with status to stop taking payments while keeping its history, and set it back to active to restore it. A new price applies to checkouts opened after the change.
When 402pay disables a link, for example for breaking the Acceptable Use Policy, it's archived with disabled_at set, and it stays archived until 402pay turns it back on.
Path
idstring RequiredThe link's ID, such aslnk_nt842tPNne3lf0ka.
Body
amountintegerThe price in minor units ofcurrency:4900withUSDis $49.00. From the equivalent of $1.00 up to 1,000,000.00 in the currency.currencystringUSD, EUR, GBP, CAD, AUD. Defaults to USD.namestringWhat the customer is paying for, up to 80 characters. It becomes the description of each payment made through the link, shown on the receipt.descriptionstringMore about it, shown in the checkout's details, up to 300 characters.success_urlstringWhere checkout sends the customer after paying, withpayment_idadded to its query. Usehttps://;http://works only forlocalhostand127.0.0.1. Defaults to the redirect in your checkout settings, then the receipt.statusstringactiveorarchived. You receivelink.archivedorlink.restored.
Errors
- 400
invalid_requestA field is missing, unknown or out of range.fieldnames it. - 404
not_foundNo link with that ID belongs to your business. - 403
test_mode_unavailableA test key can't change, archive or restore links on a live business, so use a live key. - 409
link_disabled402pay disabled the link, sostatuscan't go back toactive.
Any request can also fail on its key or its body. See errors.
Request
curl -X PATCH "https://dash.402pay.co/api/v1/links/lnk_nt842tPNne3lf0ka" \ -H "Authorization: Bearer $PAY402_SECRET_KEY" \ -H "Content-Type: application/json" \ -d '{ "status": "archived" }'Response200 OK
{ "data": { "id": "lnk_nt842tPNne3lf0ka", "kind": "link", "code": "v6e4mrczwg", "url": "https://checkout.402pay.co/checkout/v6e4mrczwg", "name": "Team plan, monthly", "description": "Everything in Pro for up to 10 people.", "amount": 19900, "currency": "USD", "success_url": null, "status": "archived", "disabled_at": null, "payments_count": 1, "volume": { "amount": 17910, "currency": "USD" }, "created_at": "2026-09-26T21:22:46.992Z", "updated_at": "2026-09-26T21:23:16.755Z" }}