跳到主要内容

创建通知端点

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

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

POST /v1/webhook-endpoints

创建一个用于接收收款和退款事件通知的端点,并生成签名密钥。

Attributes​

属性位置类型必填说明
Idempotency-Keyheaderstring是本次操作的唯一键;重试沿用原值
urlbodystring是可公开访问的通知接收地址;正式环境必须使用 HTTPS,测试环境也允许 HTTP
enabledbodyboolean否是否启用通知投递,默认 true

请求示例​

POST /v1/webhook-endpoints
Authorization: Bearer inv_test_...
Content-Type: application/json
Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000
{
"url": "https://merchant.example.com/webhooks/invisi",
"enabled": true
}

返回示例​

200 OK,返回完整的 Webhook Endpoint 对象,包含签名密钥。请保存 secret,后续查询与更新不返回此属性。

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

业务错误码