{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/charge-config","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/guides/charge-config","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","ConfigurableTabs","ConfigurableTab","img"]},"type":"markdown"},"seo":{"title":"Charge configuration","description":"An API for end-to-end transaction solution that seamlessly integrates payments, fulfillment, and support into your marketplace.","llmstxt":{"hide":false,"title":"Trustap API","description":"Trustap is an API for end-to-end transaction solution that seamlessly integrates payments, fulfillment, and support into your marketplace. Trustap is an escrow API service facilitating secure transactions.","sections":[{"title":"Intro","description":"Trustap API introduction.","includeFiles":["docs/v2.0/intro/*.md"],"excludeFiles":[]},{"title":"Concepts","description":"Trustap Concepts","includeFiles":["docs/v2.0/concepts/*.md"],"excludeFiles":["docs/v2.0/concepts/errors.md"]},{"title":"Guides","description":"Trustap integration guides","includeFiles":["docs/v2.0/guides/**/*.md"],"excludeFiles":["docs/v2.0/guides/listing/"]},{"title":"API Reference","description":"Trustap API reference guide","includeFiles":["**/apis/@v2.0/openapi.yaml"],"excludeFiles":[]}],"excludeFiles":[]},"meta":[{"name":"robots","content":"noindex"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"charge-configuration","__idx":0},"children":["Charge configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Charge configuration defines how Trustap fees are applied to payments (buyer flat and percentage fees) and payouts (seller flat and percentage fees)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Using the Trustap API, you can define multiple charge configurations to control the following."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Who pays the transaction processing fees (buyer, seller, or both)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The payment method (card or bank transfer)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The fee structure (flat fee, percentage, or a combination)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When different configurations apply"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Trustap API supports multiple charge configurations that, once set up, can be dynamically applied to your transactions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"setup-your-charge-configurations","__idx":1},"children":["Setup your charge configurations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Trustap configures and manages your charge configurations for you. You can set multiple configurations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Contact your Trustap integration specialist with the following details."]},{"$$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":"Field name"},"children":["Field name"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Config ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The ID of the charge configuration. This is the ID you’ll use  as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charge_config"]}," when referring to this config"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The currency of your transactions. The Trustap API can use this to automatically select a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#scenario-4-different-fees-for-different-currencies"},"children":["charge_config"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["eur"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A fixed fee (in your currency’s smallest unit) charged to the buyer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["50"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The percentage fee charged to the buyer, expressed as a decimal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A fixed fee (in your currency’s smallest unit) charged to the seller"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The percentage fee charged to the seller, expressed as a decimal"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["3"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["int"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The threshold amount used to determine when this charge configuration applies. For example, if you want the configuration to only be applied to transactions with a value above £100. Default value is 0. The Trustap API can use this to automatically select a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#scenario-1-different-payment-methods-for-high-value-items"},"children":["charge_config"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10000"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Method"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The method of payment for your transactions. Can be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_transfer"]},". The Trustap API can use this to automatically select a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#scenario-5-different-fees-for-different-payment-methods"},"children":["charge_config"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bank_transfer"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For multiple charge configurations, send a full set of details for each configuration."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"charge-configuration-scenarios","__idx":2},"children":["Charge configuration scenarios"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-1-different-payment-methods-for-high-value-items","__idx":3},"children":["Scenario 1: Different payment methods for high-value items"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you want to use different fee structures depending on the payment method and transaction value, you can define separate charge configurations with different thresholds."]},{"$$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":"Config ID"},"children":["Config ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer flat fee"},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer percentage fee"},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller flat fee"},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller percentage fee"},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Charge config threshold"},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["10000"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bank_transfer"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explanation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Trustap API checks the value of the transaction against the charge config threshold and automatically selects the correct charge config."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Card payments apply standard fees for all transactions below €100."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Bank transfers apply reduced fees for transactions above €100"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-2-lower-charges-for-gold-silver-bronze-memberships","__idx":4},"children":["Scenario 2: Lower charges for gold, silver, bronze memberships"]},{"$$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":"Config ID"},"children":["Config ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer flat fee"},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer percentage fee"},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller flat fee"},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller percentage fee"},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Charge config threshold"},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explanation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each membership tier has its own configuration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the correct Config ID when creating a transaction based on the user’s membership level."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-3-seller-pays-fees-for-small-value-transactions","__idx":5},"children":["Scenario 3: Seller pays fees for small value transactions"]},{"$$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":"Config ID"},"children":["Config ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer flat fee"},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer percentage fee"},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller flat fee"},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller percentage fee"},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Charge config threshold"},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5000"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explanation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Trustap API checks the value of the transaction against the charge config threshold and automatically selects the correct charge config."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For low-value transactions (below €50), sellers cover all fees."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["For higher-value transactions, both buyer and seller share the cost."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-4-different-fees-for-different-currencies","__idx":6},"children":["Scenario 4: Different fees for different currencies"]},{"$$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":"Config ID"},"children":["Config ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer flat fee"},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer percentage fee"},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller flat fee"},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller percentage fee"},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Charge config threshold"},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gbp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1.5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explanation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Trustap API checks the currency of the transaction and automatically selects the correct charge config."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Euro transactions have a higher charge than British pound."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"scenario-5-different-fees-for-different-payment-methods","__idx":7},"children":["Scenario 5: Different fees for different payment methods"]},{"$$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":"Config ID"},"children":["Config ID"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer flat fee"},"children":["Buyer flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Buyer percentage fee"},"children":["Buyer percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller flat fee"},"children":["Seller flat fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Seller percentage fee"},"children":["Seller percentage fee"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Charge config threshold"},"children":["Charge config threshold"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Payment method"},"children":["Payment method"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eur"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["bank_transfer"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["gbp"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["card"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Explanation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Trustap API checks the payment method of the transaction and automatically selects the correct charge config."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Transactions with a bank transfer have a lower charge than card payments."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-charge-configuration","__idx":8},"children":["Using charge configuration"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/concepts/pricing"},"children":["pricing guide"]}," for more information on how pricing works with the Trustap API."]}]},{"$$mdtype":"Tag","name":"ConfigurableTabs","attributes":{"id":"transaction-type","urlParam":"trans_type"},"children":[{"$$mdtype":"Tag","name":"ConfigurableTab","attributes":{"label":"Online transaction","value":"online","default":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You use your charge config at two points in the transaction flow."," ","You must use the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," as you set in your charge configuration. If you do not set a charge config, the Trustap API uses a default value of 1."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When calculating your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/online-payment/basic.getcharge"},"children":["transaction charge"]}," using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charge_config"]},"."," ","http://localhost:4000/apis/v1.0/openapi/online-payment/basic.getcharge"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Get charge","header":{"title":"Get charge","controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/charge?price=20000&currency=eur&payment_method=bank_transfer&charge_config=3' \\\n --user '<API_KEY>:'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/online-transactions/basic.createtransactionwithguestuser"},"children":["create your transaction"]}," using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charge_config"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Create an online transaction","header":{"title":"Create an online transaction","controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/me/transactions/create_with_guest_user' \\\n--header 'Trustap-User: 1-af6c21b1-6252-449e-b340-90391667221b' \\\n--header 'Content-Type: application/json' \\\n --user '<API_KEY>:' \\\n--data '{\n \"seller_id\":\"1-af6c21b1-6252-449e-b340-90391667221b\",\n\"buyer_id\":\"1-0b444755-e112-4286-8edf-3ca634e37f63\",\n\"creator_role\": \"seller\",\n\"currency\": \"eur\",\n\"description\": \"Online transaction\",\n\"price\": 20000,\n\"charge\": 40,\n\"charge_calculator_version\": 5,\n\"charge_config\":3,\n\"skip_remainder\": true,\n\"payment_method\": \"bank_transfer\"\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"ConfigurableTab","attributes":{"label":"Face-to-face transaction","value":"f2f","default":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You use your charge config at two points in the transaction flow."," ","It's essential that you use the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payment method"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}," as you set in your charge configuration. If you do not set a charge config, the Trustap API uses a default value of 1."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When calculating your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/f2f-payment/p2p.getcharge"},"children":["transaction charge"]}," using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["charge_config"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Get charge","header":{"title":"Get charge","controls":{"copy":{}}},"source":"  curl --location 'https://dev.stage.trustap.com/api/v1/p2p/charge?price=20000&currency=eur&Payment method=bank_transfer&charge_config=3' \\\n --user '<API_KEY>:'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["When you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/f2f-transactions/p2p.createtransactionwithguestuser"},"children":["create your transaction"]}," using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deposit_charge_config"]},"."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Create a face-to-face transaction","header":{"title":"Create a face-to-face transaction","controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/p2p/me/transactions/create_with_guest_user' \\\n--header 'Trustap-User: 1-af6c21b1-6252-449e-b340-90391667221b' \\\n--header 'Content-Type: application/json' \\\n --user '<API_KEY>:' \\\n--data '{\n \"seller_id\":\"1-af6c21b1-6252-449e-b340-90391667221b\",\n\"buyer_id\":\"1-0b444755-e112-4286-8edf-3ca634e37f63\",\n\"creator_role\": \"seller\",\n\"currency\": \"eur\",\n\"description\": \"Face-to-Face no deposit\",\n\"deposit_price\": 20000,\n\"deposit_charge\": 80,\n\"charge_calculator_version\": 3,\n\"deposit_charge_config\":3,\n\"skip_remainder\": true,\n\"deposit_payment_method\": \"bank_transfer\"\n}'\n","lang":"CURL"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"view-charges","__idx":9},"children":["View charges"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can view charges in two places."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Trustap payment screen showing the buyer fee as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buyer Protection Fee"]},"."]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/payment-screen.0de7383af0b17fabfa3f781d7aeb02fda25b4138515036fad19b7bed2072df0e.7d99d8e5.png","alt":"Trustap payment screen showing buyer payment fee","withLightbox":true},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":2},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Trustap seller transaction page as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Buyer Fees"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Seller Fees."]}]}]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/seller-console.16f49c92498405913bf5bd3ce5d61dacd266f3a2922728dcc2d48b9fdddb233e.7d99d8e5.png","alt":"Trustap payment screen showing buyer and seller fees","withLightbox":true},"children":[]}]},"headings":[{"value":"Charge configuration","id":"charge-configuration","depth":1},{"value":"Setup your charge configurations","id":"setup-your-charge-configurations","depth":2},{"value":"Charge configuration scenarios","id":"charge-configuration-scenarios","depth":2},{"value":"Scenario 1: Different payment methods for high-value items","id":"scenario-1-different-payment-methods-for-high-value-items","depth":3},{"value":"Scenario 2: Lower charges for gold, silver, bronze memberships","id":"scenario-2-lower-charges-for-gold-silver-bronze-memberships","depth":3},{"value":"Scenario 3: Seller pays fees for small value transactions","id":"scenario-3-seller-pays-fees-for-small-value-transactions","depth":3},{"value":"Scenario 4: Different fees for different currencies","id":"scenario-4-different-fees-for-different-currencies","depth":3},{"value":"Scenario 5: Different fees for different payment methods","id":"scenario-5-different-fees-for-different-payment-methods","depth":3},{"value":"Using charge configuration","id":"using-charge-configuration","depth":2},{"value":"View charges","id":"view-charges","depth":2}],"frontmatter":{"excludeFromSearch":true,"seo":{"meta":[{"name":"robots","content":"noindex"}],"title":"Charge configuration"}},"lastModified":"2026-04-22T08:41:41.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1.0/guides/charge-config","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}