Sign in
Connect

Create sub-merchant fee override

Creates a per-sub-merchant fee override that fully replaces global MarketplaceSettings for payins and deposits. Use 0 rates/fixed amounts for zero-fee commercial gestures.

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

Path parameters

subMerchantIdstring required

Request body

marketplaceFeeRatePer1000number

Marketplace take rate on the gross payin amount. Effective rate = value / 100_000. Examples: 2500 = 2.5%, 0 = no percentage fee.

marketplaceFeeFixedInCentsnumber

Flat marketplace fee in cents charged on every payin.

marketplaceDepositFeeRatePer1000number

Marketplace take rate on virtual-account deposits. Effective rate = value / 100_000.

marketplaceDepositFeeFixedInCentsnumber

Flat marketplace fee in cents charged on every deposit.

marketplaceFeeBearer'SUB_MERCHANT' | 'MARKETPLACE'

"SUB_MERCHANT" creates an obligation per payin/deposit. "MARKETPLACE" means no obligation — the marketplace absorbs the fee.

Response

idstring required
subMerchantUserIdstring required
marketplaceUserIdstring required
marketplaceFeeRatePer1000number required
marketplaceFeeFixedInCentsnumber required
marketplaceDepositFeeRatePer1000number required
marketplaceDepositFeeFixedInCentsnumber required
marketplaceFeeBearer'SUB_MERCHANT' | 'MARKETPLACE' required
createdAtstring date-time required
updatedAtstring date-time required

Changes