v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB

Connect

Update Connect sub-merchant profile

Partial-update of marketplace-controlled profile fields (display name, first/last name, arbitrary metadata). marketplaceMetadata is shallow-merged; reserved keys (connectKyc, _inflow_*) are silently dropped. Email, custodial wallet, KYC state, fees, and suspension are NOT mutable here — see the suspend/resume routes for the suspension toggle.

patch/api/connect/accounts/{subMerchantId}

Path parameters

subMerchantIdstring required

Example:usr_01JABCDEF0123456789XYZ

Sub-merchant user id

Request body

merchantNamestring

Display name / merchant name for the sub-merchant.

firstNamestring

First name (individual sub-merchants only).

lastNamestring

Last name (individual sub-merchants only).

marketplaceMetadataobject

Arbitrary marketplace metadata. Shallow-merged into the existing object. Reserved keys (connectKyc, _inflow_*) are silently dropped.

Example request

{
  "merchantName": "Seller Alpha",
  "firstName": "John",
  "lastName": "Doe"
}

Response

Update Connect sub-merchant profile successful

idstring required

emailstring required

merchantNamestring nullable required

firstNamestring nullable required

lastNamestring nullable required

accountType'INDIVIDUAL' | 'MARKETPLACE' | 'SUB_MERCHANT' required

marketplaceUserIdstring required

marketplaceMetadataobject nullable required

customerIdstring nullable required

KYC provider customer id linked to this sub-merchant

custodialWalletAddressstring nullable required

Custodial wallet address for this sub-merchant

stopProcessingSettlementboolean required

createdAtstring date-time required

updatedAtstring date-time required

Example response

{
  "id": "usr_01JABCDEF0123456789XYZ",
  "email": "seller@example.com",
  "merchantName": "Seller Alpha",
  "firstName": "John",
  "lastName": "Doe",
  "marketplaceUserId": "usr_marketplace123",
  "customerId": "cus_abc123",
  "custodialWalletAddress": "0xABC123…"
}