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. SuccessWhen Urlsuccessful your request will redirect this success url.
callback.failure	required | url:http,https	Required. FailWhen Urlfailure your request will redirect this failure url.
callback.callbackUrl	required | url:http,https	Required. CallbackTo urlreceive Urlreal-time notifications on order state changes, you must provide a callback url.

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"
}

Notifications via Callback URL

The callbackUrl is an endpoint on your server that our system will call via an HTTP GET request whenever the status of the specified order changes from its initial state.

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