Displaying customer's tariff on-demand in your app

Set location_id to customer’s location when creating the connect-token:

curl --request POST \
--url https://api.flatpeak.com/connect/tariff/token \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"location_id": "loc_641b90b758fb8e6293716e40",
"callback_uri": "<your webhooks receiver endpoint>",
"connect_web_uri": "<URL where Connect web is running>"
}'

Start connect session using the token you just created. Connect will return a relevant page, depending on the status if the tariff connection. This may be:

• Tariff summary
• Pending tariff connection
• Failed tariff connection

Your customer can navigate through these pages and select from a list of available actions presented on each page.

You will be starting a new session with Connect, so you must create a new Connect token. Go to create-connect-token API endpoint and include the following parameters in your request:

• Set location_id to where you want to display the tariff summary.

• Set callback_uri to any page that can accept callbacks.

  Example request

  Example response

  Copy

  Ask AI

  curl --request POST \
  --url https://api.flatpeak.com/connect/tariff/token \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "location_id": "loc_641b90b758fb8e6293716e40",
  "callback_uri": "https://webhook.site/4623e56fc5c1"
  }'
  

Run Connect. When you specify location_id when creating the connect_token, the relevant summary or pending page will be returned.