Real-World Example
ABC Collections currently has 10,000 active consumer accounts. They try to downgrade to a plan that allows only 5,000 accounts. The system should stop that change and explain that the selected plan is too small for the current account count. Later, ABC Collections upgrades to a higher plan. The system should calculate the upgrade according to the membership billing rules, charge the saved membership payment method when needed, and update the active plan.Visual Flow
Plans and Billing Cycles
Membership plans may use weekly, monthly, or annual billing cycles. Authorized users can upgrade, downgrade, change the billing cycle, replace the saved membership payment method, or cancel when the selected plan allows it. A downgrade or cycle change must still respect active account limits and the effective-date rules shown before confirmation.Cancel Membership Options
When a creditor cancels a membership, the cancellation is scheduled for the end of the current billing period. The creditor must choose one of three options:- Keep My Accounts Live: the membership ends, but the creditor profile, billing information, ecoAddress, and consumer accounts stay available.
- Keep My Profile, Cancel All My Consumer Accounts: the membership ends and consumer accounts are deactivated, but the creditor profile and billing information are saved.
- Cancel All – End of Billing Period: the membership ends and the creditor profile, ecoAddress, billing profile, users, and consumer accounts are closed through the full cancellation cleanup flow.
Membership Payment Method
The saved method can be used for membership, usage, and over-limit charges. Card or ACH details should be collected through the secure payment-provider form. YouNegotiate should store provider references and safe display details rather than raw card or bank credentials. Before saving a new method, the platform must retrieve it from the provider and verify that it belongs to the correct creditor billing customer. Replacing the method must make the verified method available for supported billing recovery without exposing full payment details. When Over Limit is enabled, saving a verified method also starts the first weekly charge for any existing extra accounts that are not already covered by an account add-on. Bank accounts must finish verification first. Existing unpaid platform balances keep their normal recovery process; saving a method does not create a separate duplicate charge for that balance. When a creditor replaces a card from Membership Settings, YouNegotiate uses the verified replacement for future billing. It keeps the old card attached while a pending payment still uses it, while a charge has an unknown outcome, or while Stripe still has it as the customer default. Once those checks clear, YouNegotiate detaches the old card. A cleanup failure can retry without changing the new billing card or payment history. For example, if ABC Collections replaces card ending in 1111 with card ending in 4242 while a Stripe payment still uses 1111, future YouNegotiate charges use 4242. The old card stays attached until that Stripe payment is resolved.Billing Card Expiry Reminders
YouNegotiate checks the creditor’s active Stripe billing card daily. Reminders start 60 calendar days before the last day of the card’s expiration month, using the creditor’s time zone. The billing contact receives at most one reminder per card every seven calendar days, through the last day of the expiration month. The reminder goes to the company email, or the owner email if the company email is blank. If Stripe updates the expiry for the active card, Membership Settings shows the new date after YouNegotiate receives the Stripe event. The daily check refreshes the date if the event was missed, including during the weekly reminder cooldown. For example, if Stripe extends the same card from November 2027 to November 2028, Membership Settings shows November 2028 and any reminder queued for the old date is skipped. The email shows only the card’s last four digits and expiration month and year. Its Update Payment Method button opens the payment-method dialog for signed-in creditors. If you need to sign in first, open Membership Settings and choose Update Payment Method. For example, if ABC Collections’ card expires June 30, the first reminder becomes eligible May 1. If ABC Collections replaces the card before a queued reminder goes out, YouNegotiate skips that email. It checks Stripe again just before sending and also skips the queued reminder if Stripe has already updated that card’s expiration.How It Should Work
- It should show the creditor’s current membership plan and available plan options.
- It should allow the creditor to update the membership payment method.
- It should clearly show whether a valid membership payment method is available.
- It should let the creditor submit a special-plan inquiry when no custom membership exists yet.
- It should keep the membership card order from the app: upgrades, special-plan inquiry card, then downgrades.
- It should prevent selecting a plan that cannot support the creditor’s active consumer count.
- Upgrades should apply according to the app’s upgrade and prorating rules.
- Same-level or downgrade changes may be scheduled for the next plan cycle when applicable.
- The creditor should be able to cancel a plan according to the available cancellation options.
- Failed over-limit payments should be retryable when the account is blocked because of over-limit billing.
How It Should Not Work
- It should not allow a downgrade below the creditor’s active consumer count.
- It should not update payment details without valid payment information.
- It should not trust an unverified payment-method reference supplied by the browser.
- It should not create a second pending special-plan inquiry for the same creditor.
- It should not charge the wrong amount for a plan change.
- It should not expose full payment credentials or attach a payment method to another creditor.
- It should not leave the creditor blocked after a successful over-limit retry.
- It should not cancel or change another creditor’s membership.
- It should not apply full profile cleanup when the creditor selected an option that keeps the profile or keeps accounts live.

