Pending tariff connection

Connect will return this page if it cannot instantly access the customer’s tariff, such as during a provider’s system outage.

Preview
Code

{
  "connect_token": "cot_6587fa4362341be5b524de3b",
  "route": "connection_pending",
  "direction": "IMPORT",
  "type": "COMMODITY",
  "live_mode": false,
  "actions": [
    "EDIT",
    "DISCONNECT",
    "BACK"
  ],
  "data": {
    "connection_type": "DIRECT",
    "provider": {
      "id": "prv_65b78bbdd8e83b06a60e38c2",
      "display_name": "Octopus Energy",
      "logo_url": "https://s.flatpeak.com/83b06a60e38c2.png"
    }
  }
}

When you POST the response, Connect may return any of these validation errors:

Error Code	Error Description
`action_missing`	Action parameter is required.
`action_invalid`	Action parameter XX is not supported.
`data_json_invalid`	Data does not conform to the JSON schema.

Supported actions:

Action	Result
`EDIT`	Restarts the flow from the Provider Selection page.
`DISCONNECT`	Disconnects the tariff and completes the session.
`BACK`	Returns previous page.
`CLOSE`	Returns `callback_url` you specified when creating the Connect token.

When a customer clicks Save, Connect will immediately complete the session, and you can obtain the Location ID. However, Tariff Rates and other API endpoints will return error 422 (“code”: “pending_connect”) until Flatpeak’s backend systems can access the tariff; this can happen in a minute, an hour, or a day. If the tariff cannot be accessed for over 48 hours, Flatpeak systems will send a webhook tariff.fetch.failed

Area Selector Failed Connection

⌘I

Core Endpoints

Connect Endpoints

Get Energy Price

Schedule Energy

Submit Telemetry

Calculate Energy Cost

Providers

Pending tariff connection

Core Endpoints

Connect Endpoints

Get Energy Price

Schedule Energy

Submit Telemetry

Calculate Energy Cost

Providers

Documentation Index