Youidian Unified Portal Docs

What this page solves: it defines the single recommended integration path for Youidian Unified Portal.
Who it is for: standard hosted integrations that want the fastest implementation path.
What you will get: one default route that an AI agent or developer can implement without making architecture choices.

What Youidian Unified Portal provides

Youidian Unified Portal hosts these capabilities:

• product, pricing, and payment channel configuration
• unified product-list retrieval with product entitlements
• hosted payment pages and order creation flow
• hosted login pages and multi-channel identity entry
• server-side order, entitlement, and login verification APIs
• automatic recurring entitlement maintenance for subscription plans

The real SDK version in this repository is @youidian/sdk v3.1.0.

Single recommended path

The default documentation teaches one route only:

1. Install @youidian/sdk
2. Use PaymentUI from @youidian/sdk/client on the frontend
3. Use LoginUI from @youidian/sdk/client on the frontend
4. Use PaymentClient from @youidian/sdk/server on the backend
5. After payment, let your backend query the order, read entitlements, and grant business access
6. After login, let your backend verify loginToken and create the local user session

In the default path:

• payment usually starts by loading the product list, then uses productCode
• login uses loginToken
• your business does not create the order first
• user entitlements are hosted by the unified platform by default
• you do not need apiUrl, checkoutUrl, loginUrl, baseUrl, or allowedOrigin

Starting in SDK v3.1.0, integrators can also call getActiveSubscription(userId) on the backend when they want to decide whether a pricing page should show “already purchased”, “upgrade”, or “manage plan”. That decision belongs to the integrator backend, not the public hosted checkout page.

For special control requirements, private deployment, or custom domains, see Advanced Integration.

Recommended payment flow

Your backend
  -> getProducts(...)
  -> Your pricing page shows products, prices, and entitlements
  -> Your frontend PaymentUI.openPayment({ appId, userId, productCode })
  -> Youidian Unified Portal hosted payment page
  -> User confirms product and pays
  -> Youidian Unified Portal creates and advances the order
  -> Frontend receives success callback with orderId
  -> Your backend queries order / entitlements
  -> Your system grants access or refreshes account state

Recommended login flow

Your frontend
  -> LoginUI.openLogin({ appId })
  -> Youidian Unified Portal hosted login page
  -> User signs in
  -> Frontend receives loginToken
  -> Frontend posts loginToken to your backend
  -> Backend verifyLoginToken(loginToken)
  -> Your system matches or creates the local user and session

Reading order

1. Installation
2. Payment Integration
3. Login Integration
4. Advanced Integration
5. Payment Channel Reference
6. WeChat Mini Program Integration
7. Integration Checklist

Common mistakes to avoid

• Do not treat @youidian/sdk/login as the default entry
• Do not start the default payment path with a custom order creation flow
• Do not trust frontend login data without verifying loginToken
• Do not surface advanced override fields as standard hosted setup requirements