# Finqu Partner Portal

> A self-service console for partners and developers, covering onboarding, app and theme lifecycle, OAuth clients, and seller payouts.

## A self-service console for partners and developers

The Partner Portal is the self-service console for third-party and internal developers. A partner applies, reaches an approved status, sets up their brand and contacts, and then works with apps, themes, and the API clients that connect them to the platform.

It is the supply side of the marketplace. Listings and prices sync outward and entitlement webhooks come back, while the purchase record stays in Marketplace.

## App and theme lifecycle

1. **Apply**: Partnership application and approved developer status.
2. **Build**: Create an app or theme and issue the OAuth clients it needs.
3. **Version**: Cut a version and submit it for review.
4. **Publish**: Price it and publish, with share tokens for unlisted work.
5. **Get paid**: Stripe Connect onboarding for payouts to the seller.

## What the portal handles

- Partner onboarding, status workflow, brand profile, and contacts
- App and theme creation, versioning, review submission, and publishing
- Per-theme signing key pairs and structure validation on publish
- Partner-issued OAuth clients and merchant client relationships
- Stripe Connect onboarding and payout status for independent sellers
- Merchant ownership transfer through time-limited verification tokens

## Technologies

- PHP
- Vue
- OAuth 2.0
- Stripe Connect
- HMAC
