跳转到主要内容
PATCH
Update a payment link
请使用属于该支付链接所在组织、且为全部权限或勾选了 products:payment_links:write 权限(控制台中“可创建和修改”下的支付链接)的 API 密钥进行认证。只有 Owner 和 Admin 角色可以授予该权限。
  • linkId 是你组织内的支付链接 ID,例如读取产品支付链接返回的条目。
  • 请求体包含 title、description 和 successUrl,均为可选。只有你传入的字段会被修改。
  • successUrl 是绝对 HTTPS 地址。传空字符串可清除,此时客户看到 Anyway 的收据页。
  • 价格、货币和计费方式无法修改。若要以其他价格销售,请创建新的支付链接。
  • 响应为更新后的完整链接(无论是否处于启用状态),结构与读取产品支付链接中的条目相同。
  • 未知字段会被拒绝,返回 400。该接口没有 Idempotency-Key。

授权

X-API-Key
string
header
必填

Merchant API key (format: ak_BASE64)

路径参数

Payment link ID

请求体

application/json

Fields to change

title
string

New title shown on the pay page

Maximum string length: 255
description
string

New description shown on the pay page

Maximum string length: 2000
successUrl
string

Absolute HTTPS URL to send the customer to after paying. Send an empty string to clear it.

Maximum string length: 1000

响应

OK

data
object
error
object
message
string
success
boolean