---
title: "Registers a new company related to a merchant."
method: POST
path: "/related-companies"
---

# Registers a new company related to a merchant.

`POST /related-companies`

## Request

- Base URL: `https://api.test.kalixa.com/payment-service/v6`
- URL: `https://api.test.kalixa.com/payment-service/v6/related-companies`
- Auth: HTTP basic

Registers a new company related to a merchant.

## Request body

- NewRelatedCompany: Contains the data of the new related company.
  - `roles` string[], required: A list of roles that this company takes in the context of this application.
  - `name` string, required: The legal company name. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationAddress` Address, required: Contains the address of a merchant, person or company.
    - `street` string, required: The Street including housenumber, housename, etc.
    - `city` string, required: The name of the city.
    - `postalCode` string, required: The postal code of the address.
    - `country` string, required: The address country code as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `taxNumber` string, required: The taxpayer Identification Number (TIN) of the company. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationDate` string, required: The exact starting date of the corporation, as it appears on the company registry of the country of incorporation. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationNumber` string, required: The federal number assigned to the business in the company registry at the time of incorporation. Used for screening purposes by the PXP Financial Risk Team.
  - `shareOrOwnershipPercentage` number: A percentage amount that indicates the ownership participation of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `merchantId` string, required: The id of the merchant to which this company relates to. Used for associating the company with the merchant.

## Response `201`

Successful operation

- RelatedCompany: Contains the related companies' data.
  - `id` string: The server-generated id of the company which was registered or returned. Used for identifying the company in other methods e.g. getRelatedCompany.
  - `roles` string[]: A list of roles that this company holds.
  - `name` string: The legal company name. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationAddress` Address: Contains the address of a merchant, person or company.
    - `street` string, required: The Street including housenumber, housename, etc.
    - `city` string, required: The name of the city.
    - `postalCode` string, required: The postal code of the address.
    - `country` string, required: The address country code as ISO 3166-1 alpha-2 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `taxNumber` string: The taxpayer Identification Number (TIN) of the company. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationDate` string: The exact starting date of the corporation, as it appears on the company registry of the country of incorporation. Used for screening purposes by the PXP Financial Risk Team.
  - `incorporationNumber` string: The federal number assigned to the business in the company registry at the time of incorporation. Used for screening purposes by the PXP Financial Risk Team.
  - `shareOrOwnershipPercentage` number: A percentage amount that indicates the ownership participation of the person. Used for screening purposes by the PXP Financial Risk Team.
  - `merchant` ObjectWithId: Contains only the id of the resource. Used for future extensibility.
    - `id` string: The id of the resource.
  - `documents` ObjectWithId[]
    - `id` string: The id of the resource.

## Other responses

- `400`: Error occurred

---

[API](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding.md) - [All operations](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/llms.txt) - [OpenAPI document](https://skmtc.dev/kalixa/apis/payment-service-v6-merchant-onboarding/revisions/066120f66046?raw)