Skip to content

How to Extend an Active Pawn Contract (Verlängerung)

Purpose

When a borrower cannot redeem their collateral prior to the contract maturity date, they may extend the pawn loan (Verlängerung) by paying accrued monthly interest and storage fees. This guide details the exact 5-step modal procedure in Cashy-Hub.

Prerequisites & Role Permissions

  • Required Role: Counter Operator, Store Clerk, Branch Manager, or Administrator.
  • Contract Status: Deal must be active and stored (typically status PAYED_AND_STORED, EXTENDED, or within statutory grace period).

How Deal Extensions Work

In Cashy-Hub, extending a pawn loan spawns a new child contract linked to the original parent agreement, resetting the maturity calendar while settling accumulated parent fees.

sequenceDiagram
    autonumber
    actor Operator as Store Operator
    participant Wizard as Deal Wizard (Management Mode)
    participant Modal as Extension Dialog (5 Steps)
    participant CashBook as Store CashBook Ledger
    participant Central as Central Cashy System (/api/deals)

    Operator->>Wizard: Double-click Deal Card -> Open Management Mode
    Operator->>Wizard: Click 'Extend' in Top Action Bar
    Wizard->>Modal: Open Deal Extension Modal (Deal #, Customer)
    Operator->>Modal: Step 1: Review Loan Summary -> Click Continue
    Operator->>Modal: Step 2: Set New Duration (Months) -> Click Continue
    Operator->>Modal: Step 3: Choose Loan Adjustment -> Click Continue
    Operator->>Modal: Step 4: Review Fees & Child Fee Rate -> Click Continue
    Operator->>Modal: Step 5: Select Payment Type & Mandatory CashBook
    Operator->>Modal: Click 'Confirm Extension'
    Modal->>Central: Register rollover & create child contract
    Modal->>CashBook: Book fee inflow transaction
    Modal->>Wizard: Close modal & refresh timeline

Step-by-Step Extension Procedure

Step 1: Open the Extension Modal

  1. On the Home Kanban board or Deals directory (/deals), locate the customer's active deal.
  2. Double-click the card to open the Deal Wizard in Management Mode.
  3. In the Deal Wizard top action bar (next to the stepper), click the Extend button.
  4. The Extend Deal modal opens displaying:
  5. Header: Title "Extend Deal", subtitle "Deal #{dealId} • {customerName}".
  6. Progress Section: 5-segment progress bar.

Step 2: Step 1 of 5 — Deal Summary

  • Visual Title: STEP 1 OF 5 — DEAL SUMMARY
  • Fields Displayed:
  • Original principal loan balance (€).
  • Contract creation date.
  • Current maturity due date.
  • Action: Verify contract details with the customer and click Continue.

Step 3: Step 2 of 5 — Duration & Base Fees

  • Visual Title: STEP 2 OF 5 — DURATION & BASE FEES
  • Fields & Controls:
  • Duration (Months): Select the additional extension term (e.g. 1, 2, or 3 months).
  • New Due Date: The calendar preview computes the new maturity deadline based on the extension period.
  • Action: Confirm the extended date with the customer and click Continue.

Step 4: Step 3 of 5 — Loan Adjustment

  • Visual Title: STEP 3 OF 5 — LOAN ADJUSTMENT
  • Options (Radio Selection):
  • no_adjustment (Default): Standard term rollover. The principal loan amount remains unchanged.
  • redemption (Partial Repayment): Borrower wishes to pay down part of the loan principal along with the fees.
    • An input field Redemption Amount (€) appears.
    • The new child loan principal is reduced by this amount.
  • additional_payout (Principal Top-Up): If collateral valuation allows, the store issues additional cash to the borrower.
    • An input field Additional Payout Amount (€) appears.
    • The new child loan principal is increased accordingly.
  • Action: Select the appropriate radio option, enter any principal adjustment amounts, and click Continue.

Step 5: Step 4 of 5 — Fee & Policy Overrides

  • Visual Title: STEP 4 OF 5 — FEE & POLICY OVERRIDES (or STEP 4 OF 5 — REVIEW)
  • Fields & Controls:
  • Parent Fees Due Today (€): Displays accumulated monthly interest and storage fees that the borrower must settle today to validate the extension.
  • Next Contract Fee Rate Dropdown: Configures the monthly interest/storage rate applied to the upcoming term (e.g. Standard (4% / month)).
  • Allow online extension Toggle: When enabled, permits the borrower to pay subsequent extensions digitally via the customer web portal.
  • Action: Review financial terms and click Continue.

Step 6: Step 5 of 5 — Payment & Final Review

  • Visual Title: STEP 5 OF 5 — PAYMENT & FINAL REVIEW
  • Fields & Mandatory Selections:
  • Financial Summary: Total fees payable today, principal adjustments, and net balance due at the counter.
  • Payment Type Dropdown: Select Cash, Card, Bank, or Unzer.
  • Select CashBook Dropdown (MANDATORY): Select the active store cash drawer (e.g. Munich Main Cash or Vienna Counter Till).

[!IMPORTANT] Mandatory CashBook Binding: Cashy-Hub strictly requires binding extension fee receipts to a specific shop CashBook. An extension cannot be confirmed without an active CashBook selection.

  • Action: Click the primary Confirm Extension button.
  • The transaction is committed to the database.
  • A cash flow entry is recorded in the selected CashBook ledger.
  • An official Extension Receipt (Verlängerungsschein) is generated for printing.
  • The modal closes, and the deal card refreshes on the Kanban board.