---
title: "Update Submerchant"
method: PATCH
path: "/submerchant/{submerchantId}"
tags: ["subMerchant"]
---

# Update Submerchant

`PATCH /submerchant/{submerchantId}`

Merge-update a sub-merchant's draft onboarding form with a Phase-1 field
subset. Only fields present in the body are changed — previously-set
fields (from this or an earlier call) are preserved, except that
`websiteUrls`/`developmentUrls` are whole-array replacements: providing
a shorter array than a previous call clears the now-unused trailing
discrete fields rather than leaving them stale. Rejects once the
sub-merchant's application has been submitted for underwriting review.

## Path parameters

- `submerchantId` string, required

## Headers

- `Authorization` string, required

## Request body

- IsvSubmerchantFields
  - `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

## Response `200`

Ok

- PatchSubmerchantResponse
  - `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
  - `merchantId` string, required

## Other responses

- `404` — Submerchant Not Found

---

[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)