创建通知端点
开放待确认。 查看适用范围。
POST /v1/webhook-endpoints
创建一个用于接收收款和退款事件通知的端点,并生成签名密钥。
Attributes
| 属性 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
Idempotency-Key | header | string | 是 | 本次操作的唯一键;重试沿用原值 |
url | body | string | 是 | 可公开访问的通知接收地址;正式环境必须使用 HTTPS,测试环境也允许 HTTP |
enabled | body | boolean | 否 | 是否启用通知投递,默认 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"
}