Shop configuration

PCIFIC's tools are not tuned to one kind of shop. You tell them about yours with settings: what your shop is called, what language and voice to write in, and a few switches and limits for each tool. Your listing fields (see Set up your listing fields) say what a listing looks like. Settings say how the tools should behave around it.

Plain-text settings, including business names and registered addresses, shop names, language, AI notices, What can be listed, Safeguard instructions and banned items, verdict names, Ask’s fallback message and the embed button label, refuse HTML tags when saved. Remove tags and use plain text. Comparisons such as 2 < 3 and weights such as <50g are accepted.

Shops

Your business can run more than one shop. Each shop has its own shared and tool settings, listing fields, documents, PixelTrace photos, spending limits, usage, logs and test key daily allowance, and nothing of one shop is visible to another shop's calls. Your API keys, team, credit balance, billing, privacy tiers, own AI model, tool releases, saved test key cap and PixelTrace code letters belong to the whole business. One key works for every shop: name the shop with ?marketplaceId=<id> on every call, whatever the method. GET /api/v1/marketplaces lists your shops and their ids. While your business has one shop you may leave marketplaceId out. Once it has more than one, a call that needs a shop and names none is refused with 400 MARKETPLACE_ID_REQUIRED; PCIFIC never guesses. Usage, analytics and the monitoring summary cover every shop together when no shop is named.

• Adding, renaming and deleting shops needs a test key with the settings permission, or an owner or admin on the dashboard. A live key can list shops but never change them.
• A new shop starts from scratch: every setting at its default, no listing fields, no documents. Or copy parts of one of your shops once: safeguard, orbit, ask-pcific and pixel-trace (each tool's settings, its rules and behaviour), marketplace (the language, voice and AI notice below, but not the name the tools use), listing-fields (the working copy and every published version) and documents (Ask PCIFIC's documents). Leave copy out to copy every part.
• A copy is made once. After that the two shops are independent: changing one never changes the other.
• Each shop has the full limits on this page for itself, for example 2,000 characters of Safeguard instructions and 600 of Ask PCIFIC tone notes per shop, so each brand gets its own words.
• On the dashboard, the shop switcher is in the Your account menu at the foot of the left menu. The shop you choose there is the one the Shop, settings, documents and Usage pages show and change. Add new shop opens a guided setup: name the shop, start from scratch or copy from an existing shop, pick what to copy, and confirm.

curl https://business.pcific.ai/api/v1/marketplaces \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY"

curl -X POST https://business.pcific.ai/api/v1/marketplaces \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Voltback","copyFrom":"<id of the shop to copy>","copy":["safeguard","orbit","ask-pcific","pixel-trace"]}'

The examples below send ?marketplaceId=$PCIFIC_SHOP_ID. While your business has one shop you can leave it out; once it has more, every call that reads or changes a shop's settings must name the shop.

How settings work

Every address takes GET to read and PUT to change, for one shop at a time. You can also change the same settings on the Shop settings page of your dashboard, for the shop chosen in the switcher, as an owner or admin. Members can read but not change.

Who can change settings

• A test key with the settings permission can read and change every group on this page. Read-only keys (the read permission) can read.
• A live key can read settings but is always refused with 403 KEY_NOT_ALLOWED when it tries to change one. Make the change on the dashboard or with a test key. This stops a leaked production key from changing how your account is set up.
• Pick a voice and listing style from PCIFIC's six choices. Free-text instructions describe what your buyers care about; they cannot change PCIFIC's rules, facts or scores. About describes only what your shop sells, never how listings sound or look.

Shared settings

GET and PUT /api/v1/marketplace/settings. These are used by more than one tool. Send null to put a setting back to its default.

curl -X PUT "https://business.pcific.ai/api/v1/marketplace/settings?marketplaceId=$PCIFIC_SHOP_ID" \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Threadloop","language":"English","voice":"warm"}'

Orbit settings

GET and PUT /api/v1/orbit/settings. Orbit writes listings from a seller's photos and notes into your listing fields. These settings tell it what you sell, how a listing should read, and what to do with the photos you upload.

curl -X PUT "https://business.pcific.ai/api/v1/orbit/settings?marketplaceId=$PCIFIC_SHOP_ID" \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"about":"We sell second-hand phones and laptops to people in the UK. Listings should be short and factual.","currency":"GBP"}'

Safeguard settings

GET and PUT /api/v1/safeguard/settings. Safeguard scores every listing from 0 to 10. A verdict is your own name for a part of that scale. Settings never change the score, only what you do with it.

curl -X PUT "https://business.pcific.ai/api/v1/safeguard/settings?marketplaceId=$PCIFIC_SHOP_ID" \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"minimumScore":8,"bannedItems":["Replica or counterfeit designer goods"]}'

Ask PCIFIC settings

GET and PUT /api/v1/ask-pcific/settings. Ask PCIFIC answers a buyer's question from the documents you add. These settings control when it may search the web, how a changed document goes live, and what it says when it has no answer.

Ask PCIFIC can also look an item up by its id at an address of yours (/api/v1/ask-pcific/item-source). That, and the documents it answers from, are on the Ask PCIFIC page.

curl -X PUT "https://business.pcific.ai/api/v1/ask-pcific/settings?marketplaceId=$PCIFIC_SHOP_ID" \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"supportLink":"https://example.com/help"}'

PixelTrace settings

GET and PUT /api/v1/pixel-trace/settings. PixelTrace records seller photos in a camera page and checks new photos against photos already used in your shop. These settings control how long a camera link lasts, how photos are kept and what a public certificate shows.

curl -X PUT "https://business.pcific.ai/api/v1/pixel-trace/settings?marketplaceId=$PCIFIC_SHOP_ID" \
  -H "Authorization: Bearer $PCIFIC_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keepPhotos":false,"codePrefix":"BRE"}'

Errors

Errors that any address can return are on the Errors, limits and retries page. These are the ones settings add.

Words used on this page

• Shop: one of your business's shops, with its own settings, listing fields, documents and usage. The API calls it a shop and its id marketplaceId.
• Setting: a value you choose that changes how a tool behaves for a shop.
• Null: JSON's word for nothing. Sending null for a setting puts it back to its default.
• Verdict: your own name for a part of Safeguard's 0 to 10 scale, such as Looks good.
• Zero retention: keeping nothing after the work is done.

Related guides

• Getting started
• Build it yourself
• Set up your listing fields
• API keys and permissions
• Safeguard listing check
• Orbit listing generation
• Ask PCIFIC
• PixelTrace