Update Shop
Shop
Update Shop
Update shop / business settings
PUT
Update Shop
This endpoint is part of the merchant Admin API and is authenticated with a
merchant access token (not an app OAuth access token). The OAuth App API
exposes the store read-only via
GET /api/v1/shop.json;
there is no app-scoped shop-update endpoint.Update Shop
The OAuth App API is read-only for the shop resource — there is noPUT /api/v1/shop.json. To read shop details over the App API, use
Get Shop (GET /api/v1/shop.json, scope
read_shop).
Shop / business settings are updated through the merchant dashboard API
using a merchant (or staff) JWT, not an OAuth app access token. The relevant
endpoint is PUT /account/add-business-detail. Only the fields you send are
updated.
Request
Body Parameters
All parameters are optional. Only provided fields will be updated.Business / shop name.
Business contact email.
Business phone number.
Store owner’s name.
Store category.
Store country. Currency is auto-resolved from the store’s country.
Store address.
Tax / GST registration number.
Countries the store ships to / supports (e.g.
["India", "United States"]).Supported language codes (e.g.
["en", "es", "fr"]).Default storefront language code (e.g.
"en").Use manually-entered exchange rates instead of live API rates.
Manual exchange rate map keyed by currency code, based on the store’s default
currency (e.g.
{ "USD": 1.0, "EUR": 0.92, "INR": 83.12 }).Currency conversion fee percentage (0–10).
The store logo is updated via the separate
PUT /account/add-business-logo
endpoint (multipart upload).Response
Responses use the platform response envelope:status, state, message,
data.
Notes
- Currency is auto-resolved from the store’s country; there is no standalone currency field on this endpoint.
- Domains and plan / billing changes are managed in the dashboard, not via this endpoint.