{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Manage advances","siteUrl":"https://docs.peachfinance.com","description":"API and product documentation for Peach Finance, a lending-as-a-service platform."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"manage-advances","__idx":0},"children":["Manage advances"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Manage Advances tool lets you update the status of advances on a Multiple Advances installment loan. Use this tool to settle a pending advance, cancel a scheduled advance, or change an advance's processing state."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Availability:"]}," All clients"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required permissions:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["loan.advance:update"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Loan status:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["active"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Loan types:"]}," Installment with Multiple Advances only"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"manage-an-advance","__idx":1},"children":["Manage an advance"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["From the agent-view Borrower Portal, open the loan and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Loan options"]}," > ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manage advances"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The form displays a list of advances on the loan. Select the advance you want to update. Only advances in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," status can be selected — other statuses are disabled."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the new ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status"]}," from the dropdown. The available options depend on the advance's current status:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pending"]}," advances: Settled, Pending."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["scheduled"]}," advances: Scheduled, Settled, Pending, Canceled."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the advance is in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," status, you can also update the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advance date"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Amount"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If your company requires a Case ID, select a case from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Case ID"]}," dropdown. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-only-tools/agent-tools-overview#case-id-requirement"},"children":["Global behaviors — Case ID requirement"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Update advance"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The advance updates immediately with the new status and details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"field-reference","__idx":2},"children":["Field reference"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Values / Format"},"children":["Values / Format"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advance"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The advance to update. Only ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," advances are selectable."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Radio group from advance list"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The new status for the advance. Options vary by current status (see table below)."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select (see status transitions)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Advance date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The date for the advance. Only shown and editable for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," advances."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Date"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The advance amount. Only shown and editable for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}," advances."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Case ID"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The case associated with this action."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Conditional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Select from open cases. Required when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["forceCaseIdOnAgentActions"]}," is enabled."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"status-transitions","__idx":3},"children":["Status transitions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Current status"},"children":["Current status"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Available new statuses"},"children":["Available new statuses"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Settled, Pending"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scheduled"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Scheduled, Settled, Pending, Canceled"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-pages","__idx":4},"children":["Related pages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-only-tools/agent-tools-overview"},"children":["Agent-only loan tools"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-only-tools/agent-tools-manage-payments"},"children":["Manage payments"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/servicing-operations/agent-only-tools/agent-tools-close"},"children":["Close a loan"]}]}]}]},"headings":[{"value":"Manage advances","id":"manage-advances","depth":1},{"value":"Manage an advance","id":"manage-an-advance","depth":2},{"value":"Field reference","id":"field-reference","depth":2},{"value":"Status transitions","id":"status-transitions","depth":3},{"value":"Related pages","id":"related-pages","depth":2}],"frontmatter":{"seo":{"title":"Manage advances"}},"lastModified":"2026-10-27T01:01:07.870Z","pagePropGetterError":{"message":"","name":""}},"slug":"/servicing-operations/agent-only-tools/agent-tools-advances","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}