Real-World Example
ABC Collections creates a creditor account, but they have not connected a merchant account yet. Because required setup is incomplete, the sidebar should show Set Up Wizard with the number of required steps still left. When the creditor logs in, the wizard should open and show a checklist of missing setup items. Normal portal access should stay restricted until every required blocker is complete. Old Stripe consumer merchant configurations are removed. ABC Collections must connect Authorize.net or USAePay before consumer payments can run. After ABC Collections connects the supported merchant account, that step should show a checkmark and the sidebar count should decrease. Once all required setup steps are complete, the wizard should disappear and the creditor should use the normal portal navigation. After paid onboarding, ABC Collections is a Pending Member (PM) while activation requirements remain. Completing the six required setup items and either successfully importing a consumer or adding a notice response as a hosted account makes it an Active Member (AM). Optional setup items remain optional, and membership status does not replace a profile’s CP, YP, CRP, or VCRP classification. Moh Corp has paid and completed setup but has never imported a consumer. Receiving a notice leaves it PM; successfully choosing Add Account for that notice makes it AM. Returning the notice or accepting an invitation alone does not activate membership. ABC Collections can complete the other setup items while its initial ACH membership payment processes. Membership Payment Processed stays incomplete until Stripe confirms success. New-account uploads and SFTP imports stay blocked during that wait. If ABC Collections pays its $100 membership by ACH and the bank later returns the settled debit, Membership Payment Processed shows that payment needs attention. New-account uploads and SFTP imports are blocked again. The creditor can update the payment method in Membership Settings and reprocess the original $100 payment. Uploads resume when Stripe confirms the replacement and the other required setup steps are complete.Visual Flow
What The Wizard Includes
The wizard is a high-level checklist and progress tracker. It should help the creditor know what is missing and where to go, but it does not need to fully explain every setup form.Required Steps
Required steps are blockers. They are counted in the sidebar and control whether the creditor can use the normal portal.- Connect merchant account.
- Create header profiles for imports.
- Set Pay Terms Offers. Master terms include opening terms, automatic approval thresholds, and creditor review thresholds.
- Create terms and conditions templates.
- Create About Us profile.
- Membership Payment Processed.
Completion Criteria
Optional Steps
Optional steps can appear in the checklist, but they are non-blockers. They should not count in the sidebar and should not prevent portal access.- Set up sub-accounts.
- Set up SFTP connection.
- Configure logo size, consumer links, QR code, and embed code using standard YouNegotiate branding.
Workflows Unlocked After Setup
When all required blockers are complete, the creditor can use account imports and processing, offer delivery, consumer negotiations, and other standard portal workflows. Optional items remain configurable later from Manage Account. If ABC Collections tries to import accounts before configuring Pay Term Offers, the import response identifies Pay Term Offers as a missing step. If a scheduled SFTP import is skipped for incomplete setup, the import log lists the same missing steps.How It Should Work
- It should show only when at least one required setup step is missing.
- It should automatically guide the creditor to the missing setup items when required setup is incomplete.
- The sidebar count should equal missing required blockers only.
- The checklist can include both required and optional setup items.
- Completed items should show a checkmark.
- Completing a required step should decrease the sidebar count.
- Completing an optional step should not affect portal access.
- Normal portal access should remain restricted while required blockers exist.
- Once every required step is complete, the wizard should be removed and the creditor should gain full portal access.
- After setup is complete, required and optional setup items should be managed from Manage Account in the left menu navigation.
- Initial payment processing is a waiting state, with no repeat charge while the obligation remains pending.
- Updating a payment method alone does not complete payment verification.
- When payment, required setup, and existing upload restrictions are satisfied, send one creditor notification: “Your membership payment has been processed, and your ecoPortal™ is ready for account uploads.”
How It Should Not Work
- It should not stay visible as incomplete after all required setup is done.
- It should not allow a creditor to skip required setup when that setup is needed for portal features.
- It should not block portal access because optional setup steps are incomplete.
- It should not inflate the sidebar count with optional setup helpers.
- It should not show setup steps that are irrelevant to the creditor account.
- It should not try to replace the detailed Manage Account pages for each setup area.
- Active membership alone must not mark the initial payment successful. Existing creditors without reliable initial-payment evidence remain blocked from new-account uploads and SFTP imports until verified.
- Duplicate callbacks and page refreshes must not create duplicate charges or readiness messages.

