> For the complete documentation index, see [llms.txt](https://stamply.gitbook.io/stamply-knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://stamply.gitbook.io/stamply-knowledge-base/api/marketplace-beta.md).

# Marketplace (Beta)

Neben der direkten Stamply API gibt es einen zweiten Integrationsmodus: **Marketplace Apps**.

### Wann brauchst du Marketplace?

Marketplace ist relevant, wenn du eine Integration als installierbare App anbieten willst – mit standardisiertem Setup-Flow, Credential-Validierung und optional Inventory-/Rules-Support.

Typische Fälle:

* POS-Apps, die Merchant-weit installierbar sein sollen
* Integrationen, die während der Installation Credentials prüfen müssen
* Integrationen, die ein Inventory/Menu-Tree brauchen (z. B. für regelbasierte Logik)

### Wann brauchst du Marketplace nicht?

Für die meisten POS-Eigenintegrationen reicht die direkte Stamply AP**I** (siehe [POS Integration Guide](https://stamply.gitbook.io/stamply-knowledge-base/~/revisions/PIhPWkG1gRwwX3y6P5lk/api/stamply-api/pos-integration-guide) und [Stamply API](https://stamply.gitbook.io/stamply-knowledge-base/~/revisions/PIhPWkG1gRwwX3y6P5lk/api/stamply-api)).\
Wenn dein System lediglich bei Verkauf/Refund Loyalty buchen muss, ist Marketplace in der Regel Overkill.

### Technischer Überblick

Marketplace erfordert:

1. Einen separaten **Application Service** (dein Integrations-Backend), der Endpoints wie Credential-Check und Inventory bereitstellt.
2. Marketplace API Calls (z. B. “accrue/reverse”) mit einem separaten **App-Token**.

### Status

Marketplace ist bei Stamply aktuell in **Beta**. Wenn du eine Marketplace-App bauen willst, kontaktiere uns für Enablement & Prozess via <info@stamply.ch>.