Islamic Decor Gifts

Etsy app

A private tool for one shop

It connects the Islamic Decor Gifts Etsy shop to its owner, and to nobody else.

The short version

The application is built for our own shop. The owner is its only user: there are no accounts, no sign-ups and no features for visitors. It lets the owner view and edit listings and see orders without leaving a single screen.

What it does

What it does not do

Permissions requested

shops_rIdentify the shop the app is attached to.
listings_rRead titles, descriptions, prices and stock.
listings_wSave the changes the owner makes to listings.
transactions_rRead orders so they can be prepared for shipping.

How the connection is made

  1. The owner signs in on the private seller page with the site password.
  2. The owner ticks the box to accept the app terms and the privacy policy. The time and the version of the terms are stored.
  3. The browser is sent to Etsy, which uses OAuth 2.0 with PKCE. Etsy shows the permissions above and asks for consent. The Etsy password is entered on Etsy only.
  4. Etsy sends the browser back with a one-time code, and the app exchanges it for tokens.
  5. Tokens are encrypted with AES-256-GCM before they are stored. The status page tells the owner whether the link is active and never shows a token.

If any Etsy account other than the owner’s approves the request, the tokens are discarded immediately.

Ending the connection

The owner can choose Disconnect on the seller page, which deletes the stored tokens straight away. The same can be done from Etsy, on the connected-apps page of the account settings. Either way the app loses access at once.

The term 'Etsy' is a trademark of Etsy, Inc. This Application uses Etsy's API, but is not endorsed or certified by Etsy.