> ## Documentation Index > Fetch the complete documentation index at: https://docs.boomfi.xyz/llms.txt > Use this file to discover all available pages before exploring further. # Update Sub-Merchant Fees > Change the fees on a merchant you onboarded. Send only the fees you want to move — anything omitted keeps its current value — and the response reports every fee on the merchant afterwards. partner_payment_rev_share_pct sets your own fee share for this one merchant, overriding your partner default; send it as null to remove the override. ## OpenAPI ````yaml /openapi.yaml patch /partners/orgs/{orgId}/fees openapi: 3.1.0 info: contact: email: support@boomfi.xyz name: API Support description: >- The BoomFi Merchants API provides a set of endpoints for merchants to manage their accounts, transactions, and more. Hosts differ per brand/environment; use the brand-specific base URL from the docs. title: BoomFi Merchants API version: '1.0' servers: - url: https://mapi.boomfi.xyz/v1 description: Production - url: https://mapi-test.boomfi.xyz/v1 description: Test security: [] tags: - description: Payment links name: Paylinks - description: Billing plans name: Plans - description: Subscriptions name: Subscriptions - description: Customer records name: Customers - description: Invoices name: Invoices - description: Payments name: Payments - description: Organisation events name: Events - description: Organisation profile and display settings name: Organisation - description: Webhook and request-signing secrets name: Secrets - description: Settlement accounts name: Accounts - name: Bank Address Book - description: Managed virtual accounts, balances, pay-in, and payout name: Virtual Accounts - description: Partner-managed accounts, virtual accounts, pay-in, and payout name: Partners - description: Partner maintain-balance automations name: Partner Balance Monitoring paths: /partners/orgs/{orgId}/fees: patch: tags: - Partners summary: Update Sub-Merchant Fees description: >- Change the fees on a merchant you onboarded. Send only the fees you want to move — anything omitted keeps its current value — and the response reports every fee on the merchant afterwards. partner_payment_rev_share_pct sets your own fee share for this one merchant, overriding your partner default; send it as null to remove the override. parameters: - description: Organisation ID returned by create in: path name: orgId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/partners.UpdateSubMerchantFeesRequest' description: Fees to change required: true responses: '200': description: OK content: application/json: schema: $ref: >- #/components/schemas/internal.Response-partners_SubMerchantFeesResponse '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/internal.ErrorResponse' security: - ApiKeyAuth: [] ApiNonce: [] ApiSignature: [] components: schemas: partners.UpdateSubMerchantFeesRequest: properties: default_payin_fee_pct: description: Default percentage charged on virtual-account pay-ins. example: 0.25 type: number default_payout_fee_pct: description: Default percentage charged on virtual-account pay-outs. example: 0.25 type: number offramp_fee_pct: description: Percentage charged on each offramp. example: 1 type: number partner_payment_rev_share_pct: description: >- Your fee share on this merchant, overriding your partner default. Send null to drop the override and go back to that default. example: 0.3 type: number payment_fee_pct: description: Percentage charged on each payment. example: 1.5 type: number refund_fee_usd: description: Flat fee charged per refund, in USD. example: 2 type: number swap_fee_pct: description: Percentage charged on each swap. example: 0.5 type: number type: object internal.Response-partners_SubMerchantFeesResponse: properties: data: allOf: - $ref: '#/components/schemas/partners.SubMerchantFeesResponse' description: Response payload when the request succeeded. error: description: True when the request failed. type: boolean message: description: Human-readable status or error message. type: string type: object internal.ErrorResponse: properties: error: allOf: - $ref: '#/components/schemas/internal.ErrorStruct' description: Error details including HTTP-style code and message. type: object partners.SubMerchantFeesResponse: properties: default_payin_fee_pct: description: Default percentage charged on virtual-account pay-ins. type: number default_payout_fee_pct: description: Default percentage charged on virtual-account pay-outs. type: number effective_partner_rev_share_pct: description: >- Your fee share actually applied to this merchant's payments: the override above when it is set, otherwise your partner default. type: number offramp_fee_pct: description: Percentage charged on each offramp. type: number org_id: description: Organisation ID that owns this resource. type: string partner_payment_rev_share_pct: description: >- Your fee share set specifically on this merchant. Absent when no override is in place. type: number payment_fee_pct: description: Percentage charged on each payment. type: number refund_fee_usd: description: Flat fee charged per refund, in USD. type: number swap_fee_pct: description: Percentage charged on each swap. type: number type: object internal.ErrorStruct: properties: code: description: |- Error code Example: 400 example: 400 type: integer errors: description: List of errors items: $ref: '#/components/schemas/internal.SingleError' type: array message: description: |- Error message Example: Insufficient quantity example: Insufficient quantity type: string type: object internal.SingleError: properties: domain: description: |- Domain Example: orders example: orders type: string reason: description: |- Error Reason Example: InsufficientQuantity example: InsufficientQuantity type: string type: object securitySchemes: ApiKeyAuth: in: header name: X-API-KEY type: apiKey ApiNonce: in: header name: X-API-Nonce type: apiKey ApiSignature: in: header name: X-API-Signature type: apiKey ````