Skip to content

Authentication

All Channel Partner API requests are authenticated with a token passed in the request-token HTTP header.

How it works

POST /channel/api/v1/order/submit
  request-token: <your token>


  Server looks up the channel application by token
  (must be enabled and of type "channel_partner")


  Server resolves the bound channel partner (member) from the token


  Request proceeds, scoped to that partner's bound shops

The partner identity is resolved server-side from the token. You never send a partner id in the request — this prevents one partner from acting as another.

Obtaining a token

Tokens are issued by an e2c-energy administrator, who creates a channel application bound to your channel partner account. Keep the token secret; treat it like a password.

Request header

HeaderRequiredDescription
request-tokenyesYour channel application token
Content-Typeyesapplication/json

Authentication errors

codeMeaning
909Token missing, unknown, disabled, or not of type channel_partner

When you receive 909, verify the token is correct, still enabled, and issued as a channel partner application.