{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-documentation/get_started/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Pass Processing Fees to Sub-Accounts","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pass-processing-fees-to-sub-accounts","__idx":0},"children":["Pass Processing Fees to Sub-Accounts"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["As described in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/overview/core_concepts/fees"},"children":["Fees"]}," section, Main Account holders can choose to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["pass on their Processing Fees to their Sub-Account"]}," holders. This means that when a transaction occurs, the fees associated with that transaction can be charged to the Sub-Account holder instead of the Main Account holder."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This feature is not enabled by default. Please contact support if you want to make use of them."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fee-types","__idx":2},"children":["Fee Types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There are various fees associated with processing a payment that can be passed on to Sub-Accounts, depending on the chosen pricing model."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Fee"},"children":["Fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Pricing Model"},"children":["Pricing Model"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["gatewayFee"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Any fixed cost incurred by Ryft for processing the transaction with the payment gateway"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blended, ICC++"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["processor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Ryft's processing fee markup"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blended, ICC++"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["interchange"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The fee paid to the card issuer for each transaction within the card network"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICC++"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["network"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The fee paid to the card scheme (e.g. Visa or Mastercard) for using their network"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICC++"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["miscPassThrough"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The various miscellaneous fees that are passed through from third parties"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICC++"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["combined"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An aggregate field which refers to all of the above. This can be used to request that all fees be charged to a given sub account"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICC++"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"platform-fee-model","__idx":3},"children":["Platform Fee Model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Platform Fee"]}," model, you can choose to pass on the Processing fees to the Sub-Account by setting the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSettings.platform.paymentFees.<any_of_the_above_fee_type>.bookTo.<sub_account_id>"]}," field when creating a Payment Session as shown below:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Platform Fee Model - Pass Fees - Payload Example","header":{"title":"Platform Fee Model - Pass Fees - Payload Example","controls":{"copy":{}}},"source":"{\n  // Same as previous Platform Fee example\n  \"amount\": 2050,\n  \"currency\": \"GBP\",\n  \"customerEmail\": \"customer@mail.com\",\n  \"platformFee\": 205,\n  // Pass Processing Fees to Sub-Account\n  {\n  \"paymentSettings\": {\n    \"platform\": {\n      \"paymentFees\": {\n        \"combined\": {\"bookTo\": \"ac_XXXXXXX\"}  // Sub-Account ID\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the example above, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["any"]}," Processing fee (set by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["combined"]}," keyword) will be passed on to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sub-Account"]},", which will receive the total amount for their food order (£20.50), minus the Platform Fee (£2.05), minus any Processing Fee."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With this set-up, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Main Account"]}," will receive the total amount of Platform Fee of £2.05 without any other deductions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"split-payment-model","__idx":4},"children":["Split Payment Model"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When using the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Split Payment"]}," model, you can choose to pass on the Processing fees to the Sub-Account(s) by setting the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentSettings.platform.paymentFees.<any_of_the_above_fee_type>.bookTo.<sub_account_id>"]}," field when creating a Payment Session as shown below:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","data-title":"Split Payment Model - Pass Fees - Payload Example","header":{"title":"Split Payment Model - Pass Fees - Payload Example","controls":{"copy":{}}},"source":"{\n  // Same as previous Split Payment example\n  \"amount\": 7100,\n  \"currency\": \"GBP\",\n  \"customerEmail\": \"customer@mail.com\",\n  \"splits\": {\n    \"items\": [\n      {\n        \"accountId\": \"ac_123456789\",  // Restaurant A\n        \"amount\": 2800,\n        \"fee\": {\"amount\": 280}\n      },\n      {\n        \"accountId\": \"ac_246810121\",  // Restaurant B\n        \"amount\": 2900,\n        \"fee\": {\"amount\": 290}\n      },\n      {\n        \"accountId\": \"ac_369121518\",  // Restaurant C\n        \"amount\": 1400,\n        \"fee\": {\"amount\": 140}\n      }\n    ]\n  },\n  // Pass Processing Fees to Sub-Account\n  {\n    \"paymentSettings\": {\n      \"platform\": {\n        \"paymentFees\": {\n          \"combined\": {\"bookTo\": \"ac_123456789\"}  // Restaurant A\n        }\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the example above, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["processor"]}," fee will be passed on to the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sub-Account related to Restaurant A"]},", which will receive the total amount for their food order (£14.00), minus the Platform Fee (£1.40), minus ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["any"]}," Processing Fee."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With this set-up, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Main Account"]}," will receive the total amount of Platform Fee of £7.10 without any other deductions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"next-steps","__idx":5},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To process a payment with Processing Fees passed to Sub-Accounts, no special SDK configuration is required. You can follow the steps outlined in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/get_started/process_payments"},"children":["Process Payments"]}," guide."]}]},"headings":[{"value":"Pass Processing Fees to Sub-Accounts","id":"pass-processing-fees-to-sub-accounts","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Fee Types","id":"fee-types","depth":2},{"value":"Platform Fee Model","id":"platform-fee-model","depth":2},{"value":"Split Payment Model","id":"split-payment-model","depth":2},{"value":"Next Steps","id":"next-steps","depth":2}],"frontmatter":{"seo":{"title":"Pass Processing Fees to Sub-Accounts"}},"lastModified":"2026-03-13T08:30:00.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/get_started/initiate_payments/additional_settings/pass-processing-fees","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}