تاجر جني
Which API?
Merchant API For merchants: manage your own catalogue, orders and finances through the v2 Third-Party API. Application API For partner apps: browse Gini merchants and products, send customers to checkout and follow their orders.

New: Application API docs

Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.

Merchant dashboard
Resources
MCP server

API documentation

Everything you need to integrate with the Gini v2 Third-Party API.

Getting started API reference Store API Finance API Settings API Insights API Wholesale API Resources
MCP server Endpoint summary Error responses Rate limiting Changelog

MCP server

Run your store from an AI assistant. The MCP server gives Claude your orders, catalog, discounts, staff, settings and finances as tools, acting as you.

POST https://merchant.gini.iq/mcp/merchant
How it works
  • Each tool does exactly what the same action does on the dashboard, for your store only.
  • Sign in as the owner or as an operator. An operator sees only the tools their role allows — a cashier gets orders, not products or finance.
  • Two ways to connect: a custom connector in claude.ai, Claude Desktop or Claude mobile (you sign in once with your dashboard login), or your API key and secret as headers (Claude Code and other MCP clients).
Connect from claude.ai or Claude Desktop
1

Add the connector. In Claude, open Customize → Connectors, click +, choose Add custom connector, and paste the URL above. Leave the OAuth fields empty.

2

Sign in. Claude opens the Gini merchant login. Sign in as you do on the dashboard — owner or operator.

3

Authorize. Check what Claude will be able to do and that access is returned to claude.ai, then click Authorize.

Notes
  • Access tokens last an hour and Claude refreshes them for up to 30 days; after that you sign in again.
  • Deactivating an operator, or the store, cuts their connector off at once.
Connect with headers
Headers
Field Type Required Description
X-Api-Key string Required Your API key from Settings → Integrations.
X-Api-Secret string Required Your API secret, as-is. Not signed — the MCP server needs no signature.
Claude Code 
claude mcp add --transport http gini-store https://merchant.gini.iq/mcp/merchant \
  --header "X-Api-Key: <your API key>" \
  --header "X-Api-Secret: <your API secret>"
Notes
  • Header sign-in acts as the store owner.
  • A client that can only send a bearer token can send Authorization: Bearer <API key>:<API secret> instead.
  • Missing or wrong credentials, or an inactive store → 401. 60 requests per minute.
Tool Role needs What it does
get-dashboard-stats any Wallet, orders by status, payouts, abandoned carts.
list-orders, get-order any Orders with filters; each shows can_move_to, the statuses it may move to next.
accept-order, hand-off-order, mark-order-on-the-way any Move an order forward, by the same rules as the dashboard.
reject-order, mark-order-returned any Irreversible, refund paid orders. Marked destructive — assistants ask first.
list-reject-reasons, list-branches any Reason ids for reject-order; branch ids for hand-off-order.
search-products, get-product Catalog Your products.
update-product-stock, set-product-visibility Catalog Stock and price; show or hide (a quality-check lock or pre-order keeps it hidden).
create-product, update-product, delete-product, list-categories Catalog Products, with images by link.
list-attributes, create-attribute, update-attribute, delete-attribute Catalog Variant attributes and their values.
list-product-variants, generate-product-variants, save-product-variants, delete-product-variant Catalog A product's variants (variant images on the dashboard).
list-product-addons, create-product-addon, update-product-addon, delete-product-addon Catalog A product's add-ons.
list-collections, create-collection, update-collection, delete-collection Catalog Collections, cover image by link.
list-discounts, get-discount, create-discount, update-discount, set-discount-active, delete-discount Discounts Discounts, cover image by link.
get-branch, create-branch, update-branch, delete-branch Branches Branches.
list-operators, create-operator, update-operator, delete-operator Operators Staff accounts and roles.
list-influencers, create-influencer, update-influencer, delete-influencer Influencers Influencers and their codes.
list-reels, update-reel, delete-reel any Reels (new videos on the dashboard).
list-reviews, request-order-cancellation any Customer reviews; ask the carrier to cancel a handed-over shipment.
get-profile, update-profile, update-store-logo, update-store-cover owner The store profile; writes are the owner's only.
get-opening-hours, set-opening-hours, get-ordering-schedule, set-ordering-schedule Settings Weekly hours, per branch.
get-delivery-settings, update-delivery-settings Settings Pickup, delivery and charges per governorate.
get-settlements-summary, list-debts Finance Transfers, fees, amount waiting, debts.
list-notifications any The bell, without marking anything read.
Notes
  • The create, update and delete tools run the same code as the matching API endpoint, so its fields and rules apply — see that endpoint's page.
  • Images are public https links. The server downloads them; a link to an internal address, a redirect or a non-image is refused.
  • No tool marks an order delivered: the delivery company or the customer's QR scan does.
  • A refused action comes back as a tool error with the dashboard's own message.
Previous Seller orders Next Endpoint summary