跳到主要内容

更新通知端点

开放待确认。 查看适用范围。

对象与完整字段 · 认证、金额与错误 · 接入指南

PATCH /v1/webhook-endpoints/{id}

更新通知接收地址或启用状态。未传入的字段保持原值,签名密钥不变。

Attributes​

属性位置类型必填说明
Idempotency-Keyheaderstring是本次操作的唯一键;重试沿用原值
idpathstring是端点的唯一标识
urlbodystring否新的通知接收地址,不能清空;地址要求与创建时相同
enabledbodyboolean否是否启用通知投递;false 表示停用

请求示例​

PATCH /v1/webhook-endpoints/we_example
Authorization: Bearer inv_test_...
Content-Type: application/json
Idempotency-Key: 65ded8e0-a034-49cb-8d7c-4b279a7382fd
{
"enabled": false
}

返回示例​

200 OK,返回更新后的 Webhook Endpoint 对象,不包含 secret。

{
"id": "we_example",
"url": "https://merchant.example.com/webhooks/invisi",
"enabled": false,
"created_at": "2026-10-15T08:00:00Z",
"updated_at": "2026-10-15T08:10:00Z"
}

业务错误码