App Management URL

Fera had the ability to send an authenticated request to manage your app using JWT.

When you create your partner app you can define a management url that Fera will direct the user to for them to manage the app settings.

2348

Where you can set the management URL from your Fera app settings.

Authenticating Current Account

When Fera makes a request to your management URL it will include a JWT token as a jwt query parameter that is encoded using HS256 standard encryption and contains data like this:

{
  store_id: "fsto_abc123", // The Fera account/store's ID
  store_public_key: "pk_abcd123", // The Fera account/store's public API key
  store_domain: "example.myshopify.com", // The Fera store domain (website)
  owner_email: "[email protected]", // The account owner's email
  exp: 1658926619 // A unix timestamp of when the JWT token expires. Typically they last for about 15min-1hr.
}

For example, if your management URL was https://www.example.com/fera/manage then Fera might direct the user to something like:

https://www.example.com/fera/manage?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzdG9yZV9pZCI6ImZzdG9fMkx2aWRjZiIsInN0b3JlX3B1YmxpY19rZXkiOiJwa18wNmZiMTI0ZDgyZGRmNGQ4Mjc0NzUzNGZjZjhmNWI2NzgxYWM0NzMwMzNkNTRjNTJmZjIyNGFkYWZlZDZjZWU3Iiwic3RvcmVfZG9tYWluIjoiZmVyYS5haSIsIm93bmVyX2VtYWlsIjoiYWxpQGZlcmEuYWkiLCJleHAiOjE2NTg5NzQ3NTZ9.kVchBUpXm4GSzLUmE616LEsda1XFfpskwj35NazMQvE

2184

Here's where a client/store might click to get to this management URL after installing your app.