跳到主要内容

产品、托管链接和订阅

这些是帐户拥有的业务资源。需要 API 密钥或合作伙伴承载访问以及相应的启用功能。钥匙并不能打开支付途径。请参阅身份验证。

对于读取和删除，env 是一个查询过滤器。对于产品/链接创建和更新，请在 JSON 正文中发送 env。合伙人所有权来自凭证；不要发送另一个partner_id。资源价格字段可以具有端点特定的整数类型：交易 API 金额仍然是精确的整数字符串。

产品​

GET /api/v1/products?env=prod&limit=10
GET /api/v1/products/{id}?env=prod
POST /api/v1/products
PUT /api/v1/products/{id}
DELETE /api/v1/products/{id}?env=prod

创建产品定义其标题、文本、价格、数量和货币。产品不是付款。列出响应使用数据/总计；产品详细信息和创作响应使用数据。显示的价格为 1 USDT（小数点后 = 6）。

{
  "env": "prod",
  "header": "Example item",
  "text": "Example item",
  "price": 1000000,
  "qty": "1",
  "currency": "USDT"
}

托管支付链接​

GET /api/v1/links?env=prod&limit=10
POST /api/v1/links
PUT /api/v1/links/{id}
DELETE /api/v1/links/{id}?env=prod

链接是单独的服务器资源，具有金额设置、支付配置和可选产品。使用返回的资源URL/表单信息，而不是发明的URL。应用程序中生成的 Heth 接收链接是不同的对象。删除链接不会退还已结算的付款。

商家订阅​

GET /api/v1/recurrents?env=prod&limit=10
GET /api/v1/recurrents/{id}?env=prod
POST /api/v1/recurrents
PUT /api/v1/recurrents/{id}
POST /api/v1/recurrents/{id}/pause
POST /api/v1/recurrents/{id}/resume
POST /api/v1/recurrents/{id}/cancel

订阅是通过属于该帐户的成功初始付款创建的。 POST /recurrents 使用 payment_id 和一个循环对象；间隔接受每日、每周、每月或每年，其中 period 指定间隔数。付款人必须授权付款方式和定期借记条款。创建订阅并不能证明存在可用的借记权限。

生命周期操作使用 POST /recurrents/{id}/pause、/resume 和 /cancel。读取返回的状态；取消未来的费用不会退还之前的费用。 Heth 付款人在启用该功能的“设置”→“订阅授权”中通过钱包会话管理自己的加密货币订阅授权。这与商家订阅管理是分开的。

最后于 更新