@melio-eng/web-sdk 1.0.40-pr.88.ea95f3d → 1.0.40-pr.92.30fa5a1

package/README.md

@@ -135,6 +135,13 @@ Host Melio account settings within your product.
 melioSDK.openSettings(config: SettingsConfig): FlowInstance
 ```
 
+#### Entry Point (`entryPoint`)
+
+`PayFlowConfig`, `JustPayFlowConfig` and `OnboardingConfig` accept an optional `entryPoint` — which
+page of your product the user came from. Melio uses it to word the button that ends the flow (e.g.
+`"bills"` → "Back to bills"); it's wording only, your app still handles navigation. See
+[Entry point](./guides/pay-flow-integration.md#entry-point) for the full value list and an example.
+
 ### Event Handling
 
 Each flow method returns a `FlowInstance` that allows you to register event listeners:

package/dist/types.d.ts

@@ -24,53 +24,44 @@ export interface BaseFlowConfig {
     /** Optional authorization code for the flow */
     authCode?: string;
 }
-export type BusinessType = 'soleProprietorship' | 'partnership' | 'limitedLiabilityCompany' | 'corporation' | 'nonProfit' | 'nonGovernmentalOrganization' | 'municipalCorporation' | 'trustOrEstate';
-export type TaxIdType = 'ssn' | 'itin' | 'ein';
-/**
- * A US mailing address used to prefill business address fields
- */
-export interface Address {
-    street1?: string;
-    street2?: string;
-    city?: string;
-    state?: string;
-    zipCode?: string;
-}
-export interface Industry {
-    name?: string;
-    /** NAICS industry code */
-    code?: number;
-}
+export type BusinessType = 'partnership' | 'limitedLiabilityCompany' | 'corporation' | 'nonProfit';
 export interface OrganizationDetails {
     companyName?: string;
-    /** Doing-business-as name, if different from companyName */
-    dbaName?: string;
     businessType?: BusinessType;
     companyLegalName?: string;
-    taxIdType?: TaxIdType;
     taxId?: string;
     legalDateOfBirth?: string;
     website?: string;
     description?: string;
     contactPhone?: string;
-    /** Physical/operating address of the business */
-    businessAddress?: Address;
-    /** Registered legal address of the business, if different from businessAddress */
-    legalAddress?: Address;
-    industry?: Industry;
 }
 export interface UserDetails {
     email?: string;
     firstName?: string;
     lastName?: string;
     dateOfBirth?: string;
-    phone?: string;
 }
 /**
- * Entry point context for the flow, used to construct the externalOrigin parameter.
- * When provided, the externalOrigin becomes `${partnerName}-${entryPoint}` (e.g., 'your-partner-name-contacts').
- */
-export type ExternalEntryPoint = 'contacts';
+ * Which page of your product the user came from. Melio uses it to word the button that
+ * ends the flow:
+ *
+ * | `entryPoint` | return button reads |
+ * | --- | --- |
+ * | `'bills'` | "Back to bills" |
+ * | `'contacts'` | "Back to contacts" |
+ * | `'quickpayment'` | "Back to quick payment" |
+ * | `'managepayments'` | "Back to manage payments" |
+ * | `'home'` | "Back to homepage" |
+ * | `'generic'` | "Finish and return" |
+ *
+ * Use `'generic'` when your page has no single destination; omit `entryPoint` for the
+ * default wording.
+ *
+ * @remarks
+ * Wording only — it does not navigate. The `completed` event carries no destination, so your
+ * application still decides where the click lands.
+ */
+export type ExternalEntryPoint = 'bills' | 'contacts' | 'quickpayment' | 'managepayments' | 'home' | 'generic';
 /**
  * Configuration for onboarding flow
  */
@@ -78,7 +69,7 @@ export interface OnboardingConfig extends BaseFlowConfig {
     userDetails?: UserDetails;
     organizationDetails?: OrganizationDetails;
     enforceOnboarding?: boolean;
-    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    /** Which page of your product the user came from; words the button that ends the flow. See {@link ExternalEntryPoint}. */
     entryPoint?: ExternalEntryPoint;
 }
 /**
@@ -86,7 +77,10 @@ export interface OnboardingConfig extends BaseFlowConfig {
  */
 export interface PayFlowConfig extends BaseFlowConfig {
     billIds: Array<string>;
-    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    /**
+     * Which page of your product the user came from; words the button that ends the flow.
+     * Has no effect when `billIdType` is `'melio'`. See {@link ExternalEntryPoint}.
+     */
     entryPoint?: ExternalEntryPoint;
     /**
      * How the platform should resolve the provided `billIds`. Defaults to `'accounting'`.
@@ -107,7 +101,7 @@ export interface JustPayFlowConfig extends BaseFlowConfig {
     externalVendorIds: Array<string>;
     /** Optional amount to prefill in the payment flow */
     amount?: number;
-    /** Optional entry point context — affects the externalOrigin passed to the platform */
+    /** Which page of your product the user came from; words the button that ends the flow. See {@link ExternalEntryPoint}. */
     entryPoint?: ExternalEntryPoint;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@melio-eng/web-sdk",
-  "version": "1.0.40-pr.88.ea95f3d",
+  "version": "1.0.40-pr.92.30fa5a1",
   "description": "Melio Web SDK - Embed core Melio workflows directly into partner UI with minimal effort",
   "main": "dist/index.js",
   "module": "dist/index.js",