快速开始

渠道伙伴 API 允许外部合作伙伴以认证渠道伙伴的身份，在其绑定的店铺范围内向 e2c-energy 平台提报订单。身份由服务端从 API token 解析——你无需在请求体中传递伙伴 id，因此渠道伙伴只能在其绑定的店铺范围内操作。

前置条件

在提报订单前，需要 e2c-energy 管理员为你配置以下两项：

1. 渠道应用 token。 管理员创建绑定到你的渠道伙伴账户的渠道应用，并返回 request-token 密钥。该 token 用于认证每次 API 调用。
2. 至少一个绑定店铺。 管理员将一个或多个店铺绑定到你的渠道伙伴账户。你只能为绑定的店铺提报订单；其他 shop_id 会被拒绝。

基础 URL

环境	基础 URL
生产	https://apigate.e2c-energy.com

所有渠道伙伴 API 端点均位于 /channel/api/v1/ 下。

首次请求

通过一个 POST 调用来提报订单。在 request-token 头中传递你的 token，并将订单数据以 JSON 格式发送。

cURL

curl -X POST 'https://apigate.e2c-energy.com/channel/api/v1/order/submit' \
  -H 'request-token: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "shop_id": 123,
  "shop_order_no": "SO-1001",
  "shipping_standard": "STD",
  "payment_method": "bank_transfer",
  "purchase_time": "2026-07-22 10:00:00",
  "billing_address": {},
  "shipping_address": {},
  "order_item": [],
  "order_amount": []
}'

成功响应返回创建的订单 id：

{ "code": 200, "msg": "order submit succeed", "data": { "order_id": 456 } }

下一步

• 认证 — token 与身份解析机制。
• 提报订单 API — 完整请求/响应参考。
• 常见问题 — 常见问题与错误处理。