Check embedded payroll

Linking a Business

Use the following steps to establish the connection between a Layer business and a Check company.

Call the Layer Endpoint

This step establishes the mapping between a Layer business and a Check company.Endpoint: PUT /v1/businesses/{businessId}/payroll/check/configsSee the Layer documentation for full details on this endpoint.

{
  "check_company_id": "<CHECK_COMPANY_ID>"
}

Once the mapping is established, the Layer system knows to anticipate an OAuth flow.

Call the Check Endpoint

Proceed to authorize the integration with Check Payroll.Endpoint: PUT /integrations/partners/{integrationPartnerId}/authorizeSee the Check documentation for full details on this endpoint.

{
  "company": "<CHECK_COMPANY_ID>",
  "integration_permission": "<INTEGRATION_PERMISSION_ID>",
  "tos_timestamp": "<ISO_DATE>",
  "product_purchase_timestamp": "<ISO_DATE>"
}

Check IDs

The integrationPartnerId and integrationPermissionId values used in Step 2 differ between sandbox and production.

Sandbox
Production

Use these fixed values for sandbox testing:

Parameter	Value
Integration Partner ID	`int_Ccn63OpX6zKfIvssRdyB`
Integration Permission ID	`ipe_S2LMi4ckzax5YdN8BokZ`

Production IDs must be fetched from the Check API using your own credentials.Fetch the Integration Partner IDCall GET /integrations/partners and find the entry where name is "Layer".See the Check documentation for full details.

cURL

curl https://api.checkhq.com/integrations/partners \
  -H "Authorization: Bearer <CHECK_ACCESS_TOKEN>"

Response

{
  "results": [
    {
      "id": "<INTEGRATION_PARTNER_ID>",
      "name": "Layer",
      "description": "Embedded accounting"
    }
  ]
}

Fetch the Integration Permission IDCall GET /integrations/permissions and find the entry whose integration_partner matches the ID returned above and whose access_type is "Active".

cURL

curl https://api.checkhq.com/integrations/permissions \
  -H "Authorization: Bearer <CHECK_ACCESS_TOKEN>"

Response

{
  "results": [
    {
      "id": "<INTEGRATION_PERMISSION_ID>",
      "access_type": "Active",
      "integration_partner": "<INTEGRATION_PARTNER_ID>",
      "scope": []
    }
  ]
}

MCP Server

Business Use Cases

Platform Use Cases

Check embedded payroll

Linking a Business

Check IDs

​Linking a Business

​Check IDs

Linking a Business

Check IDs