Acquisitions

2.8

A suite of endpoints enabling your acquisitions customer journey to progress from an initial creation & eligibility check through to boarding/creating a successful customer.

Overview

API Reference

Key features

NewDay’s acquisition service and in-house Decision Engine NODE allow for instant credit eligibility checks.

The API returns an instant response confirming the applicant’s credit acceptability status. You can immediately proceed with the application if your customer is accepted for NewDay credit.

NewDay sends additional communications to the applicant with actions explained for any problem redressal.

Once the applicant is onboarded as a customer, they can instantly apply for the NewDay product.

If the acquisition process was interrupted owing to any technical problem, you can resubmit your request.

The following illustration explains how the customer acquisition journey will flow from quotation to providing credit to your user:

Fraud profiling

Fraud profiling can take place at any point of the acquisition journey flow providing it is before the decision endpoint is called.

Fraud profiling

Find out more

Explore the various API endpoints to see what solution is suitable for your business needs.

Application

Creating an application is the first step in the credit acquisition journey. An application typically contains personal details of the applicant along with the NewDay product they are applying for. The identifiers generated by NewDay at this stage to represent the new application will be carried over to represent all the future resources created as part of the the same applicant's journey, including the final boarding of the customer.

Using this endpoint you can create a new application record with the provided data. In a new application request, the following parameters are important and cannot be modified:

`id`

NewDay creates a unique application identifier (application id) to record the new request.

`customerRef`

You can enter a unique reference ID to identify the applicant. If the parameter is not provided from your end, NewDay will generate a unique identifier. This `customerRef` will be used for all future purposes; for example, when the applicant is finally onboarded as a NewDay customer, we refer to the same identifier when servicing the customer.

`productId`

Provide the unique reference ID of the NewDay product for which that the applicant is applying for.

Apart from the parameters mentioned above, all others are optional.

When you send a request to this endpoint, you can modify the fields in a customer’s application.

For example, you can modify details like the applicant’s residential address, contact number, email ID etc. details that were included in the request. Identifiers like the application identifier, customer reference, and product/source info cannot be updated.

This allows you to retrieve all details for any specific application record. It will bring you the latest application details using the id identifier.

Note: If the application has not gone past eligibility or decision then we will return the state as quoteAccept and substate as complexRefer (this will be changed to appStarted in the near future)

Eligibility

You can perform an eligibility check to verify whether certain initial information on applicant's credit report meets the requirements needed for availing credit. It is only a soft check at this stage and it does not impact the applicant's credit history. It is a preliminary verification that minimises chances of rejection during the actual application process, which involves a hard check of the applicant's credit history.

Benefits

The API provides credit quotation on each appropriate NewDay product and enables an applicant to instantly apply for credit.

The API responds with binary decisions — whether the applicant is accepted to apply for credit, needs to provide with additional information, or is rejected.

The API response mentions the APR of a NewDay product and the maximum credit limit allowed to the applicant

provides you with real-time credit quotation decision. You provide the application identifier id and we map it with the product information stored to check for the applicant’s eligibility for the product. It provides the following response:

quoteAccept The applicant is approved to apply for NewDay credit.

- downsell An eligibility check has been completed and the applicant has been accepted for the downsell rate.

The downsell rate is higher than the headline rate and provided to applicants that have passed our eligibility criteria, but did not qualify for the headline rate.
- If no substate is returned, an eligibility check has been completed and the applicant has been accepted for the headline rate.
The headline rate is the marketed rate for the NewDay product. These privileges are entirely optional and are not always allowed to the applicant, even when they are accepted or referred for NewDay credit.

Next steps: Applicant continues to decision. Tip: Display eligibility approved decision message.

- refer Applicant has been accepted for the headline rate but is likely to be referred following the decision call.

- referDownsell Applicant has been accepted for the downsell rate but is likely to be referred following the decision call.

Next steps: Applicant continues to decision. Tip: Display referred decision message.

- complexRefer NewDay is unable to complete an eligibility check due to a technical error.

Display message to instruct applicant to try again in 24 hours.

The following snippet explains a successful eligibility check:
quoteDecline The application for availing credit is rejected.
- dupeApplication An eligibility check has been completed and the applicant has been declined because they already have a live application.

Display a message relating to this state.
- If no substate has been returned An eligibility check has been completed and the applicant has been declined. This wil have no impact to their credit file.
  
  Display generic eligibility Decline decision message.
complex An unexpected problem has occurred, and it has not been possible to progress the current application.

The customer can re-try at any time.

The Annual Percentage Rate (APR) of the specific NewDay product will be mentioned in the response.

Decision

A request to this endpoint performs a hard check on the applicant's credit history and provides a decision. NewDay will make a complete search of the applicant's credit report and each such check is recorded on the applicant's report.

Send a PATCH request to the Application endpoint and mention the third party provided device risk profiling ID (verificationId parameter) of the applicant. This helps in the decision making process because NewDay can analyse the risk involved with extending credit to the applicant. Further information on this can be found in Fraud Profiling.

executes the apply workflow while performing a hard check on applicant’s credit report. You provide the application identifier id and we provide with the following response under the state parameter:

sign The applicant is accepted for NewDay credit. One of the following substates will be returned:

- refer A credit decision has been requested and the applicant has been referred for the headline rate.

The headline rate is the market rate for the NewDay product. These privileges are entirely optional and are not always allowed to the applicant, even when they are accepted or referred for NewDay credit.

- referDownsell A credit Decision has been requested and the applicant has been referred for the downsell rate.

The downsell rate is higher than the headline rate and provided to applicants that have passed our eligibility criteria, but did not qualify for the headline rate.

- referInstantSpend A credit decision has been requested and the applicant has been referred for the headline rate and is eligible for instant spend.

- referDownsellInstantSpend A credit decision has been requested and the applicant has been referred for the downsell rate and is eligible for instant spend.

- downsell A credit decision has been requested and the applicant has been approved for the downsell rate.

- instantSpend A credit decision has been requested and the applicant has been approved for the headline rate and is eligible for instant spend.

- downsellInstantSpend A credit decision has been requested and the applicant has been approved for the downsell rate and is eligible for instant spend.

In certain cases, the applicant might be allowed to instantly avail the NewDay credit facility; in this scenario, a temporary credit card number is provided.
- If no substate is returned a credit decision has been requested and the applicant has been approved for the headline rate.
Next steps: Applicant continues to the sign stage. Tip: Display application approved decision message.

The following snippet explains a succesful application where the applicant is allowed to proceed with signing legal agreements:
docRequired The applicant is required to provide some more documents, one of the following substates will be returned:

- declVulnCust The applicant has triggered the Vulnerable Customer Credit policy.

- proofAddr The applicant is required to provide documents for Proof of Address.

- proofId The applicant is required to provide documents for Proof of Identity.

- proofIdAddr The applicant is required to provide documents for Proof of Identity and Address.

NewDay will email applicant with next steps. Tip: Display acknowledgement page with decision pending message.
decline The applicant is refused to avail credit and the application ends, this will leave a footprint on the applicants credit file. An applicant might be rejected from applying for NewDay credit due to one of the following reasons:

- adverseBureau A credit decision has been requested and the applicant has been declined for adverse credit reasons.

- affordability The applicant’s income to expense ratio fails the NewDay’s affordability requirement.

- aml The applicant credit history check has failed the Anti-Money Laundering (AML) review.

- catchall A credit decision has been requested and the applicant has been declined. Where we do not have a mapped substate, catchall will be used.

- dupeApplication The applicant already has an exisiting application for the product.

- eligibility The applicant does not meet the eligibility requirements.

- existingCust The applicant is already an existing customer of the product.

- otherBureau The applicant has been declined for other bureau reasons, such as deceased or high recent searches etc.

- score The bureau provided credit score has failed the NewDay’s requirements.
- If no substate is returned the applicant’s credit application is complete, and the applicant has been declined.
This is the end of the applicant's journey. The substate indicates the reason for the decline decision & can be used to drive customer on-screen copy to give the applicant more specific information.
appCancelled Underwriter has cancelled the application, normally due to a duplicate application or request of the applicant.

This is the end of the applicant's journey.

Document

A request to the Documents endpoint, retrieves the Terms and Conditions the applicant needs to review and sign in order to complete the acquisition process. There are several types of documents:

Important information: the specified type (`preadequateexplanation`) refers to the Important Customer Information document

pre-SECCI: the specified type (`presecci`) refers to the Pre-contract credit information (Standard European Consumer Credit Information)

CCA: the specified type (`cca1to23`) refers to the Credit Agreement

Retrieves the document with the specified type (documentType : preadequateexplanation, presecci or cca1to23) linked to the application identifier id. The media types application/PDF and text/HTML are described in the Accept header. All document types can be generated in HTML and/or PDF according to your needs.

The following snippet explains a successful response where the document is provided in PDF:

Content-Type: application/pdf

{BINARY PDF DATA}

Sign

You can send the eSignature of the applicant that explicitly confirms they're accepting all terms and conditions of the product New Day will be providing them. When you send a request to the sign endpoint with the applicant's esignature, it implies consent of the applicant to conform with NewDay's credit guidelines.

Submit the applicant’s signature using POST /applications/{id}/signature by providing the application identifier id. In the endpoint response, you may receive any of the following responses:

appComplete The application is complete. One of the following substates will be returned:

- instantSpend The applicant’s credit application has been signed. After the applicant has been boarded they will have access to Instant Spend.

- refer The applicant’s credit application is complete but needs to be reviewed by NewDay Underwriting Team.

- referInstantSpend The applicant’s credit application is complete but needs to be reviewed by NewDay Underwriting Team.

- docReceived A document has been submitted for review by an underwriter.
- If no substate is returned the applicant’s credit application has been signed.
Next steps: Continue to customers.

The following snippet explains a successful eligibility check:

Although the credit application procedure is complete, applicant is not yet onboarded as a NewDay customer at this stage.
appCancelled The application is cancelled either because it is a duplicate request or the applicant has called the service desk to cancel the application. - If no substeate is returned, the underwriter has cancelled the application - normally due to duplicate application or request of the applicant.

This is the end of the applicants journey.
docRequired The applicant is required to provide some more documents, one of the following substates will be returned:
- declVulnCust The applicant has triggered the Vulnerable Customer Credit policy.
- proofAddr The applicant is required to provide documents for Proof of Address.
- proofId The applicant is required to provide documents for Proof of Identity.
- proofIdAddr The applicant is required to provide documents for Proof of Identity and Address.

NewDay will email applicant with next steps. Tip: Display acknowledgement page with decision pending message.

Customer Creation

An individual who has successfully applied for and received a NewDay product while entering into an agreement to make payments is termed as an on-boarded `customer`. The credit application process completes after an applicant becomes a customer. They will receive a physical credit card via post or digital access to credit, depending on what they applied for. Instant access to credit might be facilitated depending on the product type and the applicant's credit history checks.

allows to board an applicant who has added their signature as a customer, completing the acquisition process. A successful application will provide the following response:

appBoarded The application process is now complete and the applicant is onboarded as a customer, any of the following substates could be retruned:
- instantSpend The applicant’s credit application is complete, and the customer now has a Credit Account with Instant Spend. - If no substate is returned, the applicant’s credit application is complete.

Next steps: Continue on to Order Processing.

The following snippet explains a successful creation of customer, completing the specified application:

NewDay Cards Eligibility Criteria

	Below are the fields that are required for NewDay Cards to provide a credit decision to a customer. Please refer to the ApplicationCreate endpoint for the accepted formats and options for the API fields.
Section	Eligibility form question (What the customer will see)	API field name (passed across to NewDay)
About you	Title	title
	First name	firstName
	Last name	lastName
	Date of birth	dateOfBirth
	Mobile number	mobile
	Email address	email
Your address	Please find and confirm your address	currentAddress
	Enter address manually	N/A
	Flat number	flatNumber
	House name	houseName (at least one of ‘House Name’ or ‘House Number’ is required if current address is passed)
	House number	houseNumber (at least one of ‘House Name’ or ‘House Number’ is required if current address is passed)
	Street name	street
	Town/City	town
	County	county
	Postcode	postcode
	How long have you lived at this address?	movedIn
	Previous address You need to provide your previous address. This is because you’ve lived at your current address for less than 12 months.	previousAddress
	Start typing your address or postcode	N/A
	Enter address manually	N/A
	Flat number	flatNumber
	House name	houseName (at least one of ‘House Name’ or ‘House Number’ is required if current address is passed)
	House number	houseNumber (at least one of ‘House Name’ or ‘House Number’ is required if current address is passed)
	Street name	street
	Town/City	town
	County	county
	Postcode	postcode
	How long have you lived at this address?	movedIn
Your finances	How would you describe your employment status?	employmentStatus
	What’s your personal annual income?	grossAnnualIncome
	How much do you pay towards your mortgage and/or rent each month? If you share these payments, we only need to know about how much you contribute personally.	accommodationCosts
	How would you describe your relationship status?	maritalStatus
	What’s your partner’s annual income?	otherHouseholdIncome
	How many dependants do you have?	dependants
	How much do you spend each month on supporting dependants? Please tell us about any payments you make in a month towards childcare, spousal or child maintenance, school fees or other fees to care for dependants.	expenditureDependants
	Do you expect your financial situation to change in the near future which would impact your ability to make your repayments?	financialSituation

Still have questions?

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

Was this page helpful?

Navigation

Acquisitions

Key features

Fraud profiling

Fraud profiling

Application

id

customerRef

productId

Eligibility

Benefits

Decision

Document

Sign

Customer Creation

NewDay Cards Eligibility Criteria

You may also like:

Still have questions?

`id`

`customerRef`

`productId`