Your apps (for developers)

Open Developers at the top of your stores list. Your apps shows the apps you have made for the App Shop, and the two ways to make one.

Build with the assistant

Build an app opens Apps in the store you used last, with the build box open. Say what the app should do; the assistant writes it, and Storeloom reviews its code and runs it on its own servers. You need no server of your own. Try it in that store, then publish it to the App Shop (see Build an app). In your list it shows Runs on Storeloom, and it opens in the store where you built it.

Connect your own server

For an app you run yourself: give it a name and press Create app. It shows On your server and how many stores have it.

An app on your own server

• Keys: your server trades the code from an install for a token with the Client ID and Client secret. A secret is shown once, when it is made: copy it then. Make a new secret replaces it, and the old one stops working at once. The Event signing secret signs the privacy events your app receives; Send test event sends one signed event to your privacy events address.
• The name: tap the app’s name at the top to change it.
• Listing: what stores see in the App Shop: category, support email, tagline, description and Pricing. Tick Free, or untick it and type the monthly price in US dollars, from $1 to $1000 (the box takes numbers only), with an optional Free trial of a number of days or months, up to 90 days or 12 months. The App Shop shows every price in US dollars. You bill the stores that install it yourself.
• Addresses: the app address, the install address, your privacy policy and, when the app sees orders or customers, the privacy events address. All on your server, over https.
• Access: what the app asks a store for. Ask only for what it needs: stores see this before installing. With Add products to your store, and change the ones it added your app creates products through the app API and changes only the ones it created; with Set the stock of the products it added or ships for you it sets their stock, and that of the products its fulfillment service ships (those a store gave it, or, for a service that ships everything, every product sent to customers that is given to no other active service), one variant at a time, or by SKU from its warehouse’s count for the products its service ships (POST /v1/app-api/fulfillment-service/inventory, with the app’s fulfillment service on: the count is what the warehouse can still ship after the orders it has taken, and the store takes off what its orders took that the warehouse has not; a SKU left as it is comes back with why: unknown_sku, not_app_variant for a product the service does not ship, bundle or not_tracked), never a bundle’s. Stores that installed your app before you added an access grant it by installing again.
• Payment method: tick Adds a way to pay at checkout when your app takes payments (it asks for Take payments at your checkout with it). Give the name shoppers see (your provider’s), the currencies it charges in, the delivery countries it serves (empty for all), your Session address (where Storeloom asks for a payment), and if you like a Status address (where Storeloom asks how a payment stands before it lets an unpaid order go), whether it takes test payments, and whether it takes refunds, with the Refund address. Storeloom signs everything it sends with your Event signing secret; the requests, the answers and the app API calls your app reports with are in Storeloom’s payment apps guide (docs/PAYMENT-APPS.md). The icon is the method’s logo. A payment app is given buyers' email, phone and billing address, so it needs a Privacy events address, like an app that reads orders or customers.
• Images: the icon (1024 × 1024 pixels, PNG or JPEG, nothing see-through) and up to 5 screenshots. Edit icon, and the pencil under a screenshot, turn or crop it; an edited screenshot keeps its place.

Apply in the bar at the top saves your changes. Send for review sends the saved listing: a Storeloom reviewer checks it and the access it asks for, usually within two working days. While it is in review the listing is locked; Withdraw from review unlocks it. Once approved, changes you apply go back to review, and stores keep seeing the approved listing until then.

Delete an app

At the very bottom of an app on your own server, Delete app deletes it for good. After you confirm, it leaves the App Shop and your list, its client secret and event signing secret stop working, and its address stays taken, so no other app can have it. This cannot be undone.

While any store has the app installed it cannot be deleted: the page says how many stores have it. Withdraw it from the App Shop first; it can be deleted once no store has it. Payments, earnings and activity records that mention the app stay in Storeloom’s books, with the app marked deleted.