sk_test_* or sk_live_*) with scope marketplace:shops. Create credentials from Integrations → Digital platform (or Integrations → API keys with marketplace scopes).
Who this is for
Backend engineers syncing vendor storefronts and SKUs into EthioReview.Upsert a shop
(marketplace, externalShopId). Updates refresh name and metadata without creating a duplicate EthioReview account.
Response highlights
organizationProfile.id/slug— EthioReview shop accounturls.claim— link for the vendor owner to claim the listingwidget.embedSnippet— shop-level widget markupproducts[]— catalog items that are independent review targets
Upsert a product later
List shops
Claim flow
Shops start as unclaimed. Send the vendor the claim URL from the upsert response. After claim, the shop keeps its EthioReview reviews and parent link to your marketplace.One failure mode
Reusing the sameexternalShopId across two marketplaces — IDs are scoped per marketplace organization. Collisions only happen inside your own platform; use stable vendor IDs from your database.