v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB
Connect

Suspend a Connect sub-merchant

Sets stopProcessingSettlement = true. Blocks X-On-Behalf-Of actions and pauses settlement/onramp processing for this sub-merchant while leaving balance, KYC, and wallet untouched. Idempotent.

post/api/connect/accounts/{subMerchantId}/suspend

Path parameters

subMerchantIdstring required
Example:usr_01JABCDEF0123456789XYZ

Sub-merchant user id

Response

Suspend a Connect sub-merchant 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…"
}