Skip to main content

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

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.

Go To Notication Via Callback Url Page

Back to top