保留网络钩子(按需库存)

配置每个报价的 HTTPS 端点,以返回复杂列表的字段值。如果调用失败,付款仍然完成;您可以重试或手动履行。

在买家付款时从您的服务器获取许可证、账户或密钥值。

何时使用保留网络钩子

在您在购买时生成密钥或账户时,使用此功能用于复杂(唯一单位)库存。始终优先使用本地库存;网络钩子仅填补短缺。

  • 仅在每个单位实际分配时与即时自动交付一起使用。
  • 配置报价级别的默认值,或按定价选项覆盖。
  • 仅限 HTTPS。可选 HMAC 签名与出站网络钩子匹配。

安全支付失败

如果您的端点超时或返回无效数据,订单保持已付款。买家被收费;您在订单上看到错误,可以重试保留或手动附加密钥。

请求合同

在付款后,RMT 每缺少一个单位 POST 一个 reserve.item 调用,包含订单、报价、选项、字段模式和数量 1。可选请求模板 JSON 与 {{placeholders}} 合并。

规范 POST 主体(截断)

json
{
  "id": "rsv_…",
  "type": "reserve.item",
  "order": { "uid": "…", "reference": "…", "url": "…" },
  "offer": { "url": "…", "title": "…", "pageUrl": "…" },
  "option": { "id": 1, "name": "标准" },
  "fields": [{ "id": 10, "name": "许可证", "type": "text", "required": true }],
  "quantity": 1
}

响应和字段映射

返回 2xx JSON。将路径映射到 Item 字段,例如 $.license,或返回 { "entries": [{ "fieldId": 10, "value": "KEY-…" }] }。

便利响应

json
{
  "entries": [
    { "name": "许可证", "value": "AAAA-BBBB-CCCC" }
  ]
}
  • 仅许可证:从 $.license 或 $.key 映射一个文本字段。
  • 账户:从 $.email 和 $.password 映射电子邮件和密码字段。
  • 映射后缺少的必填字段计为失败。

测试、重试和安全

在报价编辑器中使用测试(发送 dryRun: true)。在订单页面上,修复端点后重试保留。切勿在电子邮件中记录秘密或完整密钥。

  1. 1在报价项目步骤中保存 HTTPS URL、响应映射和可选密钥。
  2. 2运行测试并确认映射预览。
  3. 3在失败时,打开订单,重试保留或手动创建/分配密钥。

在付款之前请勿调用保留

RMT 仅在付款成功后调用您的端点,因此放弃的结账不会消耗许可证。