---
title: "Merchant"
method: POST
path: "/merchants"
tags: ["Merchants"]
---

# Merchant

`POST /merchants`

Create a new merchant within your Forter account. The response will include a Forter-assigned merchant subsite ID to be included in the API header on future requests.

## Headers

- `api-version` string, required
- `x-forter-siteid` string, required
- `Authorization` string, required

## Request body

- MerchantCreationRequest — Create a new merchant within your Forter account. The response will include a Forter-assigned merchant subsite ID to be included in the API header on future requests.
  - `defaultMerchantCategoryCode` string, required — A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides
  - `merchantAccountCreation` object, nullable — Merchant account creation fields
    - `ip` string, nullable — IP address used by the account owner at the time of registration (in v4 format)
    - `timestamp` number, nullable — Date merchant account was created in seconds since unix epoch (UTC, Jan 1, 1970)
  - `merchantId` string, required — The merchant's internal ID in the PSP's systems
  - `name` string, required — The merchant's name in the PSP's systems. The name needs to be unique within the PSP's portfolio, and can include only letters (A-Z, a-z), numbers (0-9), spaces, and the following special characters: . _ & , ^ -.

## Response `200`

Example merchantCreationResponse

- MerchantCreationResponse — Response structure for merchant registration requests
  - `defaultMerchantCategoryCode` string, required — A Merchant Category Code (MCC) is a four-digit number listed in ISO 18245 for retail financial services. MCC is used to classify the business by the type of goods or services it provides
  - `id` string, required — The merchant's Site-ID in Forter's systems. Should be used for each call related to the merchant
  - `merchantAccountCreation` object, nullable — Merchant account creation fields
    - `ip` string, nullable — IP address used by the account owner at the time of registration (in v4 format)
    - `timestamp` number, nullable — Date merchant account was created in seconds since unix epoch (UTC, Jan 1, 1970)
  - `merchantId` string, required — The merchant's internal ID in the PSP's systems
  - `name` string, required — The merchant's Site Name

## Other responses

- `400` — Bad Request (Often missing a required parameter)
- `401` — Unauthorized (No valid API key provided)
- `404` — Not Found (The requested item doesn't exist)
- `429` — Too Many Requests (The client exceeded a rate limit). Honor Retry-After before retrying.
- `500` — Server Error (Something went wrong on Forter's end)
- `default` — Typed error envelope for any undeclared 4xx / 5xx status.

---

[API](https://skmtc.net/forter/apis/forter-api.md) · [All operations](https://skmtc.net/forter/apis/forter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/forter/forter-api/revisions/d7b02e919b34/schema)