---
title: "Create Submerchant"
method: POST
path: "/submerchant"
tags: ["subMerchant"]
---

# Create Submerchant

`POST /submerchant`

Create a sub-merchant and prefill a draft onboarding form with a lean
Phase-1 field set. Caller-supplied `merchantId`/`email` map to the new
sub-merchant's identity and login; the remaining fields are validated
against the ISV Phase-1 subset and written as a draft `Onboarding` form.

## Headers

- `Authorization` string, required

## Request body

- CreateSubmerchantBody
  - `dba` string
  - `industry` 'cryptocurrency' | 'educationTraining' | 'foodBeverage' | 'healthcareWellness' | 'nonProfit' | 'professionalServices' | 'remittance' | 'retailEcommerce' | 'Sports / Recreation' | 'supplements' | 'sweepstakes' | 'technologyDigitalServices' | 'tradingCardPlatform' | 'travelHospitality' | 'other'
  - `businessEmail` string
  - `billingEmail` string
  - `billingEmailSameAsBusinessEmail` boolean
  - `businessPhoneNumber` string
  - `businessPhoneCountryCode` string
  - `websiteUrls` string[]
  - `developmentUrls` string[]
  - `privacyPolicyUrl` string
  - `termsOfServiceUrl` string
  - `returnPolicyUrl` string
  - `payinMethods` string
  - `payoutMethods` string
  - `endUserJurisdictions` string
  - `merchantId` string, required
  - `email` string, required

## Response `200`

Ok

- CreateSubmerchantResponse
  - `products` string
  - `endUserJurisdictions` string
  - `payoutMethods` string
  - `payinMethods` string
  - `returnPolicyUrl` string
  - `termsOfServiceUrl` string
  - `privacyPolicyUrl` string
  - `developmentUrl5` string
  - `developmentUrl4` string
  - `developmentUrl3` string
  - `developmentUrl2` string
  - `developmentUrl` string
  - `websiteUrl5` string
  - `websiteUrl4` string
  - `websiteUrl3` string
  - `websiteUrl2` string
  - `websiteUrl` string
  - `businessPhoneCountryCode` string
  - `businessPhoneNumber` string
  - `billingEmail` string
  - `businessEmail` string
  - `industry` 'cryptocurrency' | 'educationTraining' | 'foodBeverage' | 'healthcareWellness' | 'nonProfit' | 'professionalServices' | 'remittance' | 'retailEcommerce' | 'Sports / Recreation' | 'supplements' | 'sweepstakes' | 'technologyDigitalServices' | 'tradingCardPlatform' | 'travelHospitality' | 'other'
  - `dba` string
  - `email` string, required
  - `merchantId` string, required

---

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