---
title: "Add Sub-merchant"
method: POST
path: "/api/master-merchant/{mkey}/add-merchant"
tags: ["MasterMerchant APIs"]
---

# Add Sub-merchant

`POST /api/master-merchant/{mkey}/add-merchant`

Add or Invite the new sub-merchant. The sub merchant will asked to register if Login Flow is enabled for sub-merchant.

## Path parameters

- `mkey` string, required

## Headers

- `X-Portone-Client-Key` string
- `Authorization` string

## Request body

- object
  - `email_address` string, required — The email of sub-merchant.
  - `name` string, required — The name of sub-merchant.
  - `country` string, required — The country code of sub-merchant.
  - `is_login_allowed` boolean, required — The boolean flag indicating whether is login allowed for sub-merchant.
  - `is_invite_merchant` boolean, required — The boolean flag indicating whether to send invitation to the merchant.
  - `use_master_merchant_creds` boolean, required — The boolean flag indicating whether sub-merchant can use master merchant credentials..
  - `send_kyc_link_email` boolean, required — The boolean flag indicating whether to send KYC to the sub-merchant.

## Response `200`

Successful response

- object
  - `content` AddSubMerchantContent — The object containing the add sub merchant API response data.
    - `kyc_link` string — The KYC page URL for the sub-merchant.
  - `message` string — The description of the API request execution result
  - `status_code` string — The status_code for API request execution result
  - `status_reason` string — The status_reason for API request execution result

## Other responses

- `400` — Failure response
- `401` — Failure response

---

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