HomeGuidesAPI Reference
Guides

Refi

Help borrowers get pre-qualified to refinance their loans with Nexus.refi

When a Borrower is no longer able to leverage federal options or has private loans, the next step is often refinancing their remaining student loan debt. To guide your Borrower on the path to refinancing their loans, use Nexus.refi to help them pre-qualify and review Refi Offers. Once they complete the workflow, they will be directed to the lender to complete their application.

📘

Nexus pre-fills information Payitoff knows about your borrowers

In order to ease the process for borrowers, Nexus will pre-fill all possible information required throughout the workflow. If a borrower has used Nexus before or you have already stored information for the borrower via our API, Nexus will populate any previously saved information such as name, AGI, employment status, and contact info. The relevant Nexus screens will still be presented to the user so they may confirm or correct the pre-filled data as they complete the Refi workflow.

Calling Nexus.refi

Nexus.refi expects to receive a single options object as a parameter. This options object allows you to specify an optional onEvent callback to take actions based on your borrower's activity within Nexus:

// Assuming you have a button your Borrower can click to start the refi
let refiButton = document.querySelector('#nexus-refi-button')

// Attach click handler to invoke Nexus.refi
refiButton.addEventListener('click', e => {
  Nexus.refi({
    // the function to call when borrower is done or exits early
    onEvent: handleLinkEvent,
  })
})

Nexus Events

See our guide for using onEvent callbacks. Here is an example of the workflow_finished event.

Borrower IDs

📘

When relying on Nexus to create borrowers, you will need to capture the borrower.uuid that is returned in order to make API calls on behalf of your borrowers.