POST api/Introducer/CreditCheck
Create a new credit check
Request Information
URI Parameters
None.
Body Parameters
IntroducerCreditCheckRequestModelName | Description | Type | Additional information |
---|---|---|---|
IntroducerData | IntroducerDataModel |
None. |
|
FinanceDetails |
This model should be used to populate all the finance details requested by the system to create a Credit Check. |
FinanceDetailsModel |
None. |
CustomerDetails | CustomerInfoModel |
None. |
|
EmploymentDetails | EmploymentInfoModel |
None. |
|
BankDetails | BankDetailsModel |
None. |
|
SuppressCustomerEmails | boolean |
None. |
|
IpAddress | string |
None. |
|
Source | string |
None. |
|
MarketingPreferences | MarketingPreferencesModel |
None. |
|
AcceptAllTermsAndConditions | boolean |
None. |
|
CustomerRedirectURL | string |
None. |
|
ReturnDocumentsForSign |
This model should be used to specify whether you want the documents or just the signing link or neither. |
ReturnDocumentsEnum |
None. |
Request Formats
application/json, text/json
{ "IntroducerData": { "BranchId": "fc471ee4-c328-486b-bb3a-e8c79e930f78", "RetailerAccountCode": "sample string 1", "BranchCode": "sample string 2" }, "FinanceDetails": { "RateCardProductId": "4d341d7c-4c1e-4efe-9f02-c65e304b3c4c", "RateCardProductCode": "sample string 1", "DescriptionOfGoods": "sample string 2", "RetailersReference": "sample string 3", "Price": 1.0, "Deposit": 1.0 }, "CustomerDetails": { "MiddleName": "sample string 1", "MaidenName": "sample string 2", "BlackBoxString": "sample string 3", "TitleId": "a2521e21-7c17-486e-8923-0ce1d66393b6", "GenderId": "dac78500-4b1b-4201-a81a-437d4574379d", "MaritalStatusId": "8a972c9f-6684-43c1-a42f-18416abb47a6", "ResidentialStatusId": "913b556f-78e9-4d2e-8cc1-ff7e68a2929c", "NumberOfDependants": 1, "Vulnerability": true, "CurrentAddress": { "YearsAtAddressId": "f45801b4-c9f0-4435-85b0-9bbede9f7d4d", "PostCode": "sample string 1", "City": "sample string 2", "Flat": "sample string 3", "HouseNumber": "sample string 4", "HouseName": "sample string 5", "Street": "sample string 6" }, "PreviousAddress1": { "YearsAtAddressId": "f45801b4-c9f0-4435-85b0-9bbede9f7d4d", "PostCode": "sample string 1", "City": "sample string 2", "Flat": "sample string 3", "HouseNumber": "sample string 4", "HouseName": "sample string 5", "Street": "sample string 6" }, "PreviousAddress2": { "YearsAtAddressId": "f45801b4-c9f0-4435-85b0-9bbede9f7d4d", "PostCode": "sample string 1", "City": "sample string 2", "Flat": "sample string 3", "HouseNumber": "sample string 4", "HouseName": "sample string 5", "Street": "sample string 6" }, "GoodsDeliveryAddress": { "YearsAtAddressId": "f45801b4-c9f0-4435-85b0-9bbede9f7d4d", "PostCode": "sample string 1", "City": "sample string 2", "Flat": "sample string 3", "HouseNumber": "sample string 4", "HouseName": "sample string 5", "Street": "sample string 6" }, "CustomerEmail": "sample string 5", "FirstName": "sample string 6", "LastName": "sample string 7", "Telephone": "sample string 8", "MobileNumber": "sample string 9", "DateOfBirth": "2025-05-12T05:51:48.255947+01:00", "MonthlyRentAmount": 1.0, "GoodsDeliveryAddressIsTheSameAsCurrentAddress": true }, "EmploymentDetails": { "EmploymentStatusId": "ae4b5103-10be-462e-b442-52e63ffc8a6e", "YearsSelfEmployedId": "e931b69c-4898-462f-adee-3557c72e693c", "YearsWithEmployerId": "e49d0817-ea91-43e6-a7cc-c14156d69e01", "SourceOfIncomeId": "b95a336b-3538-4370-9988-b8e32f9c05e3", "TypeOfBusiness": "sample string 1", "BusinessName": "sample string 2", "MainOccupation": "sample string 3", "EmployerName": "sample string 4", "GrossAnnualIncome": 1.0, "HouseholdAnnualIncome": 1 }, "BankDetails": { "BankAccountNumber": "sample string 1", "BankSortCode": "sample string 2" }, "SuppressCustomerEmails": true, "IpAddress": "sample string 2", "Source": "sample string 3", "MarketingPreferences": { "ReceiveInformationViaPost": true, "ReceiveInformationViaEmail": true, "ReceiveInformationViaSMS": true, "ReceiveInformationViaPhone": true, "AgreePersonalDetailsToBeDisclosed": true }, "AcceptAllTermsAndConditions": true, "CustomerRedirectURL": "sample string 4", "ReturnDocumentsForSign": 1 }
text/html
{"IntroducerData":{"BranchId":"fc471ee4-c328-486b-bb3a-e8c79e930f78","RetailerAccountCode":"sample string 1","BranchCode":"sample string 2"},"FinanceDetails":{"RateCardProductId":"4d341d7c-4c1e-4efe-9f02-c65e304b3c4c","RateCardProductCode":"sample string 1","DescriptionOfGoods":"sample string 2","RetailersReference":"sample string 3","Price":1.0,"Deposit":1.0},"CustomerDetails":{"MiddleName":"sample string 1","MaidenName":"sample string 2","BlackBoxString":"sample string 3","TitleId":"a2521e21-7c17-486e-8923-0ce1d66393b6","GenderId":"dac78500-4b1b-4201-a81a-437d4574379d","MaritalStatusId":"8a972c9f-6684-43c1-a42f-18416abb47a6","ResidentialStatusId":"913b556f-78e9-4d2e-8cc1-ff7e68a2929c","NumberOfDependants":1,"Vulnerability":true,"CurrentAddress":{"YearsAtAddressId":"f45801b4-c9f0-4435-85b0-9bbede9f7d4d","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"PreviousAddress1":{"YearsAtAddressId":"f45801b4-c9f0-4435-85b0-9bbede9f7d4d","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"PreviousAddress2":{"YearsAtAddressId":"f45801b4-c9f0-4435-85b0-9bbede9f7d4d","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"GoodsDeliveryAddress":{"YearsAtAddressId":"f45801b4-c9f0-4435-85b0-9bbede9f7d4d","PostCode":"sample string 1","City":"sample string 2","Flat":"sample string 3","HouseNumber":"sample string 4","HouseName":"sample string 5","Street":"sample string 6"},"CustomerEmail":"sample string 5","FirstName":"sample string 6","LastName":"sample string 7","Telephone":"sample string 8","MobileNumber":"sample string 9","DateOfBirth":"2025-05-12T05:51:48.255947+01:00","MonthlyRentAmount":1.0,"GoodsDeliveryAddressIsTheSameAsCurrentAddress":true},"EmploymentDetails":{"EmploymentStatusId":"ae4b5103-10be-462e-b442-52e63ffc8a6e","YearsSelfEmployedId":"e931b69c-4898-462f-adee-3557c72e693c","YearsWithEmployerId":"e49d0817-ea91-43e6-a7cc-c14156d69e01","SourceOfIncomeId":"b95a336b-3538-4370-9988-b8e32f9c05e3","TypeOfBusiness":"sample string 1","BusinessName":"sample string 2","MainOccupation":"sample string 3","EmployerName":"sample string 4","GrossAnnualIncome":1.0,"HouseholdAnnualIncome":1},"BankDetails":{"BankAccountNumber":"sample string 1","BankSortCode":"sample string 2"},"SuppressCustomerEmails":true,"IpAddress":"sample string 2","Source":"sample string 3","MarketingPreferences":{"ReceiveInformationViaPost":true,"ReceiveInformationViaEmail":true,"ReceiveInformationViaSMS":true,"ReceiveInformationViaPhone":true,"AgreePersonalDetailsToBeDisclosed":true},"AcceptAllTermsAndConditions":true,"CustomerRedirectURL":"sample string 4","ReturnDocumentsForSign":1}
application/xml, text/xml
<IntroducerCreditCheckRequestModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.IntroducerRequestModels"> <AcceptAllTermsAndConditions xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">true</AcceptAllTermsAndConditions> <CustomerRedirectURL xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">sample string 4</CustomerRedirectURL> <MarketingPreferences xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels"> <AgreePersonalDetailsToBeDisclosed>true</AgreePersonalDetailsToBeDisclosed> <ReceiveInformationViaEmail>true</ReceiveInformationViaEmail> <ReceiveInformationViaPhone>true</ReceiveInformationViaPhone> <ReceiveInformationViaPost>true</ReceiveInformationViaPost> <ReceiveInformationViaSMS>true</ReceiveInformationViaSMS> </MarketingPreferences> <ReturnDocumentsForSign xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels">NoDocuments</ReturnDocumentsForSign> <BankDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels"> <d2p1:BankAccountNumber>sample string 1</d2p1:BankAccountNumber> <d2p1:BankSortCode>sample string 2</d2p1:BankSortCode> </BankDetails> <CustomerDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels"> <d2p1:CustomerEmail>sample string 5</d2p1:CustomerEmail> <d2p1:DateOfBirth>2025-05-12T05:51:48.255947+01:00</d2p1:DateOfBirth> <d2p1:FirstName>sample string 6</d2p1:FirstName> <d2p1:GoodsDeliveryAddressIsTheSameAsCurrentAddress>true</d2p1:GoodsDeliveryAddressIsTheSameAsCurrentAddress> <d2p1:LastName>sample string 7</d2p1:LastName> <d2p1:MobileNumber>sample string 9</d2p1:MobileNumber> <d2p1:MonthlyRentAmount>1</d2p1:MonthlyRentAmount> <d2p1:Telephone>sample string 8</d2p1:Telephone> <d2p1:BlackBoxString>sample string 3</d2p1:BlackBoxString> <d2p1:CurrentAddress> <d2p1:City>sample string 2</d2p1:City> <d2p1:Flat>sample string 3</d2p1:Flat> <d2p1:HouseName>sample string 5</d2p1:HouseName> <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber> <d2p1:PostCode>sample string 1</d2p1:PostCode> <d2p1:Street>sample string 6</d2p1:Street> <d2p1:YearsAtAddressId>f45801b4-c9f0-4435-85b0-9bbede9f7d4d</d2p1:YearsAtAddressId> </d2p1:CurrentAddress> <d2p1:GenderId>dac78500-4b1b-4201-a81a-437d4574379d</d2p1:GenderId> <d2p1:GoodsDeliveryAddress> <d2p1:City>sample string 2</d2p1:City> <d2p1:Flat>sample string 3</d2p1:Flat> <d2p1:HouseName>sample string 5</d2p1:HouseName> <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber> <d2p1:PostCode>sample string 1</d2p1:PostCode> <d2p1:Street>sample string 6</d2p1:Street> <d2p1:YearsAtAddressId>f45801b4-c9f0-4435-85b0-9bbede9f7d4d</d2p1:YearsAtAddressId> </d2p1:GoodsDeliveryAddress> <d2p1:MaidenName>sample string 2</d2p1:MaidenName> <d2p1:MaritalStatusId>8a972c9f-6684-43c1-a42f-18416abb47a6</d2p1:MaritalStatusId> <d2p1:MiddleName>sample string 1</d2p1:MiddleName> <d2p1:NumberOfDependants>1</d2p1:NumberOfDependants> <d2p1:PreviousAddress1> <d2p1:City>sample string 2</d2p1:City> <d2p1:Flat>sample string 3</d2p1:Flat> <d2p1:HouseName>sample string 5</d2p1:HouseName> <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber> <d2p1:PostCode>sample string 1</d2p1:PostCode> <d2p1:Street>sample string 6</d2p1:Street> <d2p1:YearsAtAddressId>f45801b4-c9f0-4435-85b0-9bbede9f7d4d</d2p1:YearsAtAddressId> </d2p1:PreviousAddress1> <d2p1:PreviousAddress2> <d2p1:City>sample string 2</d2p1:City> <d2p1:Flat>sample string 3</d2p1:Flat> <d2p1:HouseName>sample string 5</d2p1:HouseName> <d2p1:HouseNumber>sample string 4</d2p1:HouseNumber> <d2p1:PostCode>sample string 1</d2p1:PostCode> <d2p1:Street>sample string 6</d2p1:Street> <d2p1:YearsAtAddressId>f45801b4-c9f0-4435-85b0-9bbede9f7d4d</d2p1:YearsAtAddressId> </d2p1:PreviousAddress2> <d2p1:ResidentialStatusId>913b556f-78e9-4d2e-8cc1-ff7e68a2929c</d2p1:ResidentialStatusId> <d2p1:TitleId>a2521e21-7c17-486e-8923-0ce1d66393b6</d2p1:TitleId> <d2p1:Vulnerability>true</d2p1:Vulnerability> </CustomerDetails> <EmploymentDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels"> <d2p1:BusinessName>sample string 2</d2p1:BusinessName> <d2p1:EmployerName>sample string 4</d2p1:EmployerName> <d2p1:GrossAnnualIncome>1</d2p1:GrossAnnualIncome> <d2p1:HouseholdAnnualIncome>1</d2p1:HouseholdAnnualIncome> <d2p1:MainOccupation>sample string 3</d2p1:MainOccupation> <d2p1:TypeOfBusiness>sample string 1</d2p1:TypeOfBusiness> <d2p1:EmploymentStatusId>ae4b5103-10be-462e-b442-52e63ffc8a6e</d2p1:EmploymentStatusId> <d2p1:SourceOfIncomeId>b95a336b-3538-4370-9988-b8e32f9c05e3</d2p1:SourceOfIncomeId> <d2p1:YearsSelfEmployedId>e931b69c-4898-462f-adee-3557c72e693c</d2p1:YearsSelfEmployedId> <d2p1:YearsWithEmployerId>e49d0817-ea91-43e6-a7cc-c14156d69e01</d2p1:YearsWithEmployerId> </EmploymentDetails> <FinanceDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels"> <d2p1:Deposit>1</d2p1:Deposit> <d2p1:DescriptionOfGoods>sample string 2</d2p1:DescriptionOfGoods> <d2p1:Price>1</d2p1:Price> <d2p1:RetailersReference>sample string 3</d2p1:RetailersReference> <d2p1:RateCardProductCode>sample string 1</d2p1:RateCardProductCode> <d2p1:RateCardProductId>4d341d7c-4c1e-4efe-9f02-c65e304b3c4c</d2p1:RateCardProductId> </FinanceDetails> <IpAddress xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels">sample string 2</IpAddress> <Source xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels">sample string 3</Source> <SuppressCustomerEmails xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIRequests.CreditCheckRequestModels">true</SuppressCustomerEmails> <IntroducerData xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels"> <d2p1:BranchCode>sample string 2</d2p1:BranchCode> <d2p1:BranchId>fc471ee4-c328-486b-bb3a-e8c79e930f78</d2p1:BranchId> <d2p1:RetailerAccountCode>sample string 1</d2p1:RetailerAccountCode> </IntroducerData> </IntroducerCreditCheckRequestModel>
Response Information
Resource Description
If the credit check is with status declined there will be no returned documents. Guaranteed Application Results: Each email below leads to different credit check status.For successful testing, the logged retailer user need to have the "TestResultsProduct" in his/her available products.This product must use the "TestResultsCreditPolicty" in order for the API to make decisions based on the different email addresses.The test product can be applied to a retailer by an OCRF user.This product must be chosen when a new credit check is created. For 'accepted' status use ocapital.test1@gmail.com as customer email address. For 'referred' status use ocapital.test2 @gmail.com as customer email address. For 'declined' status use ocapital.test3 @gmail.com as customer email address. Possible error responses: 1. Invalid input fields - {"errors": {"invalidFieldName": ["Error message containing more details about the failure."], "invalidFieldName2": ["Error message containing more details about the failure."]}} 2. Error on validation bank details /Experian/ - {"LoanApplicationId" : "Id", "ErrorMessage" : "Error message from Experian"}
UpdateCustomerBankDetailsResponseName | Description | Type | Additional information |
---|---|---|---|
LoanApplicationId | globally unique identifier |
None. |
|
CreditCheckId | globally unique identifier |
None. |
|
Status | string |
None. |
|
StatusNumber | integer |
None. |
|
Documents | Dictionary of string [key] and string [value] |
None. |
|
DocumentsFormat | DocumentFormatEnum |
None. |
|
SignDocumentsUrl | string |
None. |
|
LoanReferenceNumber | string |
None. |
|
CreditCheckStatus | string |
None. |
|
CreditCheckStatusNumber | integer |
None. |
|
Info | string |
None. |
|
UpperAmendValue | decimal number |
None. |
|
InitialFinanceOfferDetails | FinanceOfferDetails |
None. |
|
NewFinanceOfferDetails | FinanceOfferDetails |
None. |
Response Formats
application/json, text/json
{ "LoanApplicationId": "0ddf7d6e-73cc-43e8-84a9-6d7236694946", "CreditCheckId": "40be5360-265e-4bd9-8827-aa532a78d1b4", "Status": "sample string 2", "StatusNumber": 3, "Documents": { "sample string 1": "sample string 2", "sample string 3": "sample string 4" }, "DocumentsFormat": 1, "SignDocumentsUrl": "sample string 4", "LoanReferenceNumber": "sample string 5", "CreditCheckStatus": "sample string 6", "CreditCheckStatusNumber": 7, "Info": "sample string 8", "UpperAmendValue": 1.0, "InitialFinanceOfferDetails": { "FirstPayment": 1.0, "MonthlyPayment": 2.0, "MonthlyInterestRate": 3.1, "APR": 4.1, "TotalInterestPayable": 5.0, "ProductCode": "sample string 6" }, "NewFinanceOfferDetails": { "FirstPayment": 1.0, "MonthlyPayment": 2.0, "MonthlyInterestRate": 3.1, "APR": 4.1, "TotalInterestPayable": 5.0, "ProductCode": "sample string 6" } }
text/html
{"LoanApplicationId":"0ddf7d6e-73cc-43e8-84a9-6d7236694946","CreditCheckId":"40be5360-265e-4bd9-8827-aa532a78d1b4","Status":"sample string 2","StatusNumber":3,"Documents":{"sample string 1":"sample string 2","sample string 3":"sample string 4"},"DocumentsFormat":1,"SignDocumentsUrl":"sample string 4","LoanReferenceNumber":"sample string 5","CreditCheckStatus":"sample string 6","CreditCheckStatusNumber":7,"Info":"sample string 8","UpperAmendValue":1.0,"InitialFinanceOfferDetails":{"FirstPayment":1.0,"MonthlyPayment":2.0,"MonthlyInterestRate":3.1,"APR":4.1,"TotalInterestPayable":5.0,"ProductCode":"sample string 6"},"NewFinanceOfferDetails":{"FirstPayment":1.0,"MonthlyPayment":2.0,"MonthlyInterestRate":3.1,"APR":4.1,"TotalInterestPayable":5.0,"ProductCode":"sample string 6"}}
application/xml, text/xml
<UpdateCustomerBankDetailsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.APIResponses.CreditCheckResponses"> <CreditCheckId>40be5360-265e-4bd9-8827-aa532a78d1b4</CreditCheckId> <CreditCheckStatus>sample string 6</CreditCheckStatus> <CreditCheckStatusNumber>7</CreditCheckStatusNumber> <Documents xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays"> <d2p1:KeyValueOfstringstring> <d2p1:Key>sample string 1</d2p1:Key> <d2p1:Value>sample string 2</d2p1:Value> </d2p1:KeyValueOfstringstring> <d2p1:KeyValueOfstringstring> <d2p1:Key>sample string 3</d2p1:Key> <d2p1:Value>sample string 4</d2p1:Value> </d2p1:KeyValueOfstringstring> </Documents> <DocumentsFormat>PDF</DocumentsFormat> <Info>sample string 8</Info> <InitialFinanceOfferDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels"> <d2p1:APR>4.1</d2p1:APR> <d2p1:FirstPayment>1</d2p1:FirstPayment> <d2p1:MonthlyInterestRate>3.1</d2p1:MonthlyInterestRate> <d2p1:MonthlyPayment>2</d2p1:MonthlyPayment> <d2p1:ProductCode>sample string 6</d2p1:ProductCode> <d2p1:TotalInterestPayable>5</d2p1:TotalInterestPayable> </InitialFinanceOfferDetails> <LoanApplicationId>0ddf7d6e-73cc-43e8-84a9-6d7236694946</LoanApplicationId> <LoanReferenceNumber>sample string 5</LoanReferenceNumber> <NewFinanceOfferDetails xmlns:d2p1="http://schemas.datacontract.org/2004/07/OmniPort.API.Services.CommonModels"> <d2p1:APR>4.1</d2p1:APR> <d2p1:FirstPayment>1</d2p1:FirstPayment> <d2p1:MonthlyInterestRate>3.1</d2p1:MonthlyInterestRate> <d2p1:MonthlyPayment>2</d2p1:MonthlyPayment> <d2p1:ProductCode>sample string 6</d2p1:ProductCode> <d2p1:TotalInterestPayable>5</d2p1:TotalInterestPayable> </NewFinanceOfferDetails> <SignDocumentsUrl>sample string 4</SignDocumentsUrl> <Status>sample string 2</Status> <StatusNumber>3</StatusNumber> <UpperAmendValue>1</UpperAmendValue> </UpdateCustomerBankDetailsResponse>