Customer Journey

Learn how to determine a user's position in their credit journey.


The Customer Journey API enables you to determine what point a user is in their credit journey so that you can support them in their next steps. There are three types of users:
  • An applicant: a user who has started a credit application to become a customer, but has not completed it.
  • A customer: a user who has a credit account.
  • Unknown: a user who has never made a credit application or is no longer known.

Customer Journey Enquiry

The Customer Journey API is the first endpoint to be called in any returning customer journey. It enables you to determine if the user is an applicant, a customer or an unknown user. Varying information is returned based on the user type:
  • For an applicant, relevant application data can be returned.
  • For a customer, relevant summary customer and account data can be returned.
  • For an unknown user, an error is returned.

This information can be used to help place the customer where they need to be in their customer journey:
  1. 1
    Use case example 1: Identify a customer before Order Processing to check their available credit so they can complete a purchase.
  2. 2
    Use case example 2: Use this API at the front of an Interactive Voice Response (IVR) telephony journey to identify a user category and provide summary information to them.
  3. 3
    Use case example 3: Identify an applicant and see where they are in the Acquisitions journey so that they can resume it.

How does the Customer Journey API work?

  1. 1
    Provide us with a unique identifier for the user so that we can identify the user's position in the customer journey, either a:
  2. 2
    If the user is identified as an applicant, we will return information about the application, such as:

    Application InformationDescription
    StateEnumerated list indicating the application state
    Credit limitThe credit limit associated with the application
    Interest rates for their productThe associated interest rates (AER, APR, SAR) for the product
    KYC statusInitiated, failed or authenticated KYC
    User registered statusIndicates whether the user has registered for online services

  3. 3
    If the user is identified as a customer, we will return information about the customer's account, such as:

    Account InformationDescription
    StatusAvailable status outcomes (open, charge off, closed, fraud, account cancelled pay down)
    Payment due dateDue date for the previous billing period, this may be null until the account goes through a billing cycle
    Credit limitsCollection of defined credit limits (type and amount)
    User registered statusIndicates whether the user has registered for online services
    User registered statusIndicates whether the user has registered for online services

The information provided by the API is then used to help a customer continue in their customer journey, whether that is Order Processing, IVR or Acquisitions.

Getting Started with NewDay

Quick start guides for how you can start working with NewDay as a partner and learn about the end-to-end processes of integrating with APIs.

Engagement with Commercial team

This section guides potential businesses on how to become a NewDay credit partner and explains the end-to-end on-boarding process.

Integration Guide for Developers

This section provides guidance on how to start building with NewDay i.e. how to integrate with NewDay's various deployment environments, getting access to APIs etc.

Still have questions

Can’t find the answer to your question? Our friendly team are more than happy to help

Was this page helpful?