Submit Company Check Request

This end point is using to verify your company information. After successfull submission it will returns:

• Company Check Uuid (we generate a unique uuid)
• Bank ID Verification URL (for customer identity verification)

---

Endpoint

POST https://stg-api.frontpayment.no/api/v1/connect/company/check

Authentication

This endpoint requires a Bearer Token for authentication. You will need to obtain this token from Frontpayment and include it in the Authorization header of your request.

Example Authorization Header: Authorization: Bearer YOUR_FRONTPAID_BEARER_TOKEN

Request Payload

The request body should be a JSON object containing information about the company.

{
    "companyId": 123879056,
    "callback": {
        "success": "https://your-success-url.com/",
        "failure": "https://your-failure-url.com/",
        "callbackUrl": "https://example.com/callback"
    }
}

Validation Rules

Make sure your request meets the following requirements:

Field	Type	Description
companyId	required | integer	Required. Company ID an integer format.
callback	required | array	Required. This field accepts an array of urls.
callback.success	required | url:http,https	Required. The URL we will redirect the user to after a successful BankID verification.
callback.failure	required | url:http,https	Required. The URL we will redirect the user to after a failed or cancelled BankID verification.
callback.callbackUrl	required | url:http,https	Required. To receive real-time notifications onafter orderbank id verification state changes, you must provide a callback url. This is an server-to-server HTTP GET request.

Response

A successful request will return a 201 Created status with the following JSON payload:

{
    "status_code": 201,
    "status_message": "OK",
    "message": "Company Check Request is Created Successfully",
    "is_data": false,
    "data": {
        "url": "https://auth.current.bankid.no/",
        "companyCheckUuid": "COMCHK1755071611"
    }
}

API returns a 510 error, it means something failed on the server side

{
    "status_code": 510,
    "status_message": "Execution Exception Occurred",
    "message": "somethingWentWrong",
    "is_error": true,
    "errors": "Array"
}

user Flow

• Your application receives the url from the initiation call.
• Redirect your user's browser to this URL.
• The user will land on our secure page and be guided through the BankID verification process.
• On Success: The user's browser is redirected to the success Url you provided. This is just a browser redirect; it does not contain result data.
• On Failure: The user's browser is redirected to the failure Url you provided.

Your Credit Check

After successfull BankID verification process we check your credit score from our side. You don't need to provide any other information for your credit check process. On successfull creadit check we chagne your comapny information check status is verified.

Notifications via Callback URL

TheAfter the BankID verification is complete successfully, we will notify your backend server via the callbackUrl you provided. This is anthe endpointmost onimportant yourstep for processing the actual data. This is a server-to-server thatcall ourby systemthe HTTP GET method.

Callback URL Parameters

We will call viayour anURL HTTP GET request wheneverwith the statusfollowing query parameters:

orderchanges state.

Parameter	Type	Description
companyCheckUuid	string	The UUID you received when initiating the call.
companyId	string	The company ID that was verified.
companyType	string	Type of theyour specifiedcompany.
companyName	string	Name of your company.
score	number	Credit Score.
riskLevel	string	credit score risk level.
scoreMessage	string	Credit score message
defaultProbability	number	Credit score probability score.
personalNumber	number	Personal number from itsyour initialBankID
contactPersonName	string	Name from your BankID
contactPersonEmail	string	Email address from your BankID
createdAt	number	Unix timestamp company check creation
checksum	string	Security hashing string

See the link below to understand how to work with the callback URL on your side and how to verify the request sent from our side.

Go To Notication Via Callback Url Page