Sign in

v1

latestOpenAPI 3.0.02026-07-24103118224.7 KB
Connect

Update Connect settings

Updates the calling marketplace's Connect settings. Only self-service fields are accepted; connectEnabled and paused are admin-only. If no settings row exists yet, one is created with platform defaults before applying the patch.

patch/api/connect/settings

Request body

marketplaceFeeRatePer1000number

Marketplace take rate on the gross payin amount. Effective rate = value / 100_000 (same scale as User.payinFeeRatePer1000). Examples: 2500 = 2.5%, 1000 = 1%, 250 = 0.25%. Capped at 10000 (10%).

marketplaceFeeFixedInCentsnumber

Flat marketplace fee in cents charged on every payin.

marketplaceFeeBearer'SUB_MERCHANT' | 'MARKETPLACE'

"SUB_MERCHANT" (default) creates an obligation per payin. "MARKETPLACE" means no obligation is created — the marketplace absorbs the fee on its own margin.

marketplaceDepositFeeRatePer1000number

Marketplace take rate on virtual-account deposits. Effective rate = value / 100_000 (same scale as marketplaceFeeRatePer1000). Applied to the deposit amount.

marketplaceDepositFeeFixedInCentsnumber

Flat marketplace fee in cents charged on every deposit.

payoutWindowHoursnumber

Cooldown in hours during which an incoming payin amount is locked against withdrawal. 0 disables the window (instant availability).

payoutWindowMaxReleaseRatenumber

Per1000 of in-window payin amount that can be released early (1000 = 100% fully locked, 0 = fully released).

payoutFeeBearer'MARKETPLACE' | 'SUB_MERCHANT'

Default bearer of payout fees when sub-merchants withdraw. Can be overridden per-payout on the payout request.

autoCreateWalletsboolean

When true, sub-merchant wallets are provisioned automatically on KYC approval. When false, wallets are created lazily on first split.

enabledCurrenciesstring[]

Stablecoins sub-merchants can receive and withdraw.

defaultRedirectUrlKycstring uri

Default URL where sub-merchants are redirected after completing KYC. Can still be overridden per createConnectAccount call.

Response

idstring required
marketplaceUserIdstring required
marketplaceFeeRatePer1000number required
marketplaceFeeFixedInCentsnumber required
marketplaceFeeBearer'SUB_MERCHANT' | 'MARKETPLACE' required
marketplaceDepositFeeRatePer1000number required
marketplaceDepositFeeFixedInCentsnumber required
payoutWindowHoursnumber required
payoutWindowMaxReleaseRatenumber required
payoutFeeBearer'MARKETPLACE' | 'SUB_MERCHANT' required
autoCreateWalletsboolean required
enabledCurrenciesstring[] required
defaultRedirectUrlKycstring nullable required
connectEnabledboolean required

Managed by Inflow. False means the Connect surface is disabled for this marketplace (all Connect endpoints return 403).

pausedboolean required

Managed by Inflow. True means fee collection + payouts are temporarily paused (e.g. compliance hold).

createdAtstring date-time required
updatedAtstring date-time required