canonical: https://jentic.com/apis/kapitalbank.az/kapitalbank # Kapitalbank Az Marketplace & Partner Management API The Kapital Bank Marketplace and Partner Management API administers merchant partners and their marketplaces. It creates and updates partner records, registers marketplaces, moves them through approval, rejection, and deactivation, and manages the contacts attached to each marketplace. Requests and responses are JSON over a single regional host, so an agent can onboard a partner or change a marketplace's status from one integration. ## For AI agents Manage merchant partners and marketplaces: create partners, register marketplaces, run approval and deactivation actions, and maintain contacts. ## Scope Does not process payments, settle transactions, or host storefronts; use it to manage marketplace partners and their status only. ## Capabilities - List and create merchant partner records - Retrieve, update, or remove a specific partner - Register new marketplaces and list existing ones - Approve, reject, or deactivate a marketplace - Update a marketplace's details - Manage the contacts attached to a marketplace ## Use cases ### Onboard merchant partners A marketplace operator needs a consistent way to register the businesses that sell through it. The Kapital Bank API creates partner records and lists existing partners, so an onboarding workflow can add a merchant and retrieve its record without manual data entry. Partner records are addressed by identifier for later updates. Example prompt: Create a partner record for a new merchant and confirm it appears in the partner list. ### Manage the marketplace approval flow New marketplaces usually pass through review before going live. The Kapital Bank API registers a marketplace and exposes approve, reject, and deactivate actions, letting an operations tool drive a marketplace through its lifecycle from a single integration. Each action targets a marketplace by identifier. Example prompt: Register a marketplace, then approve it once review passes and record the result. ### Maintain marketplace contacts Operators need current contact details for each marketplace they oversee. The Kapital Bank API lists and adds contacts for a marketplace, so a back-office system can keep the responsible people up to date as partnerships change. Contacts are scoped to the marketplace they belong to. Example prompt: Add a new primary contact to a marketplace and verify the contact list reflects the change. ### Agent-assisted marketplace operations An AI operations agent can handle routine partner and marketplace changes without a developer wiring each call. Through Jentic the agent matches an intent such as 'approve this marketplace' to the right Kapital Bank operation, runs it against the marketplace identifier, and reports the outcome. The bearer token stays in the user's Jentic One instance and never reaches the agent's prompt. Example prompt: Given a marketplace pending review, approve it and update its contact list on behalf of the operations team. ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/partners` | List merchant partner records. | | POST | `/partners` | Create a new merchant partner record. | | GET | `/marketplaces` | List registered marketplaces. | | POST | `/marketplaces` | Register a new marketplace. | | POST | `/marketplaces/{id}/approve` | Approve a marketplace. | | POST | `/marketplaces/{id}/deactivate` | Deactivate a marketplace. | | GET | `/marketplaces/{id}/contacts` | List the contacts attached to a marketplace. | ## Key resources - **Partners** — List, create, retrieve, update, and remove merchant partner records. - **Marketplaces** — Register, list, and update marketplaces. - **Marketplace status** — Approve, reject, or deactivate a marketplace by identifier. - **Contacts** — List and add the contacts attached to a marketplace. ## Why Jentic - **Setup:** Wiring this API yourself means managing a bearer token on every call, threading marketplace and partner identifiers through nested status paths, and sequencing approve, reject, and deactivate actions correctly. With Jentic you install once, import Kapital Bank from the API Directory, and store the token a single time. - **Permission scoping:** Jentic lets you grant your agent only the operations it needs, such as listing partners and marketplaces without deactivation or deletion, and enforces that on every call. - **Credential handling:** Your Kapital Bank bearer token is stored once, encrypted, by your own Jentic One instance. It is injected when a call runs and never enters the agent's prompt, logs, or context. - **Discovery method:** Agents find this API through Jentic's intent search, matching a request like 'approve this marketplace' to the right operation without hardcoded endpoints. ## Related APIs - **Shopify** — Commerce platform API for managing stores, products, and orders. - **Ecwid** — Storefront platform API for catalogs, orders, and store settings. - **Your.Rentals Marketplace** — Marketplace distribution API for listing inventory across channels. ## FAQ ### What can an AI agent do with the Kapital Bank Marketplace API through Jentic? An agent can create and update partner records, register marketplaces, drive them through approval, rejection, and deactivation, and manage marketplace contacts. Through Jentic the agent matches an intent to the right operation and runs it with your bearer token injected at execution time. ### How do I authenticate with the Kapital Bank Marketplace API? Every request uses a bearer token in the Authorization header. You store the token once in your Jentic One instance, which supplies it on each call rather than exposing it to the agent. ### Which resources does the API manage? The API covers merchant partners, their marketplaces, the status actions that move a marketplace through its lifecycle, and the contacts attached to each marketplace. It does not process payments or transactions itself. ### Does the API document rate limits? The OpenAPI specification does not state rate limits; request allowances depend on your agreement with Kapital Bank. Confirm the limits for your integration with Kapital Bank before running bulk partner or marketplace changes. ### Can I restrict what my agent is allowed to do with the Kapital Bank Marketplace API? Yes. Jentic lets you allow only the operations your agent needs, for example listing partners and marketplaces while withholding deactivation and deletion. Your Jentic One instance enforces that boundary on every call and keeps the bearer token outside the agent's context.