{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/transactions/online/online-postage-fee","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/v2.0/guides/transactions/online/online-postage-fee","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["DSteps","DStep","tabs","tab","img"]},"type":"markdown"},"seo":{"title":"Postage fee","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":"postage-fee","__idx":0},"children":["Postage fee"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Trustap API supports shipping in two ways for online transactions."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-shipping"},"children":["integrated shipping"]}," that automatically generates shipping labels and tracks parcels."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Support sellers to use their own shipping solutions and provide a mechanism to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-int-path-cc#seller-adds-tracking-details"},"children":["add tracking details to a transaction"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To support sellers using their own shipping solution, the Trustap API includes a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postage_fee"]}," parameter. Use this to add a pre-calculated postage cost to a transaction, which is then collected at the Trustap payment screen."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"add-a-postage-fee-to-a-transaction","__idx":1},"children":["Add a postage fee to a transaction"]},{"$$mdtype":"Tag","name":"DSteps","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-users","__idx":2},"children":["Create users"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-int-path-cc#create-a-guest-seller"},"children":["users for your transaction"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"calculate-the-charge","__idx":3},"children":["Calculate the charge"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Get the charge for the transaction including the path parameter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postage_fee"]},"."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Get charge","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"    curl --location 'https://dev.stage.trustap.com/api/v1/charge?price=495&currency=eur&payment_method=card&postage_fee=500'\\\n    --header 'Content-Type: application/json' \\\n    --user '<API_KEY>:'\n","lang":"curl"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Get charge response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"charge\": 325,\n    \"charge_calculator_version\": 5,\n    \"charge_config\": 1,\n    \"charge_postage_buyer\": 500,\n    \"charge_seller\": 0,\n    \"currency\": \"eur\",\n    \"payment_method\": \"card\",\n    \"price\": 495\n}\n","lang":"json"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-transaction","__idx":4},"children":["Create transaction"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your transaction, include the following parameters."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your postage fee as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postage_fee"]},". Amounts must be provided in a currency's smallest unit. For example, use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["500"]}," for €5."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["features"]}," use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_custom_postage_fee"]},"."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Create transaction","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"curl","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/me/transactions/create_with_guest_user' \\\n--header 'Content-Type: application/json' \\\n--user '<API_KEY>:' \\\n--header 'Trustap-User: 7982f8e1-883d-4805-9f18-bca9b67274d4' \\\n--data '{\n    \"seller_id\":\"7982f8e1-883d-4805-9f18-bca9b67274d4\",\n    \"buyer_id\":\"1-2b05d786-2eb0-408a-813c-9df2236edb00\",\n    \"creator_role\":\"seller\",\n    \"currency\":\"eur\",\n    \"description\":\"Online no deposit\",\n    \"price\":495,\n    \"charge\":100,\n    \"charge_calculator_version\":5,\n    \"features\":[\"use_custom_postage_fee\"],\n    \"postage_fee\":500\n}'\n","lang":"curl"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Create transaction response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"buyer_id\": \"1-2b05d786-2eb0-408a-813c-9df2236edb00\",\n  \"charge\": 100,\n  \"charge_postage_buyer\": 500,\n  \"charge_postage_client\": 0,\n  \"charge_seller\": 0,\n  \"client_id\": \"5a3d7990-9f1c-4e11-8d67-3da5b160c50a\",\n  \"created\": \"2025-11-04T14:26:10Z\",\n  \"currency\": \"eur\",\n  \"description\": \"Online no deposit\",\n  \"id\": 30854,\n  \"is_payment_in_progress\": false,\n  \"joined\": \"2025-11-04T14:26:10Z\",\n  \"price\": 495,\n  \"quantity\": 1,\n  \"seller_id\": \"7982f8e1-883d-4805-9f18-bca9b67274d4\",\n  \"status\": \"joined\"\n}\n","lang":"json"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"send-buyer-to-payment-screen","__idx":5},"children":["Send buyer to payment screen"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Direct your buyer to the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-int-path-cc#buyer-transfers-funds"},"children":["Trustap payment screen"]},"."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Payment screen URL","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"https://actions.stage.trustap.com/online/transactions/30854/guest_pay?redirect_uri=https://www.example.com\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Trustap payment screen","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Trustap payment screen includes a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shipping"]}," fee, that is collected in the total payment."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/online-postage-fee.76387bd5aa8fc7cfb33b224d0225bde21c674c8b2233031ae614a99a19b70ff5.df2da560.png","alt":"Trustap payment screen with postage_fee","withLightbox":true},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The collected postage fees are held in the Trustap vault and paid out to the platform at agreed intervals, in a similar manner to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/concepts/pricing#platform-commission"},"children":["partner commission"]},"."]}]},"headings":[{"value":"Postage fee","id":"postage-fee","depth":1},{"value":"Add a postage fee to a transaction","id":"add-a-postage-fee-to-a-transaction","depth":2},{"value":"Create users","id":"create-users","depth":3},{"value":"Calculate the charge","id":"calculate-the-charge","depth":3},{"value":"Create transaction","id":"create-transaction","depth":3},{"value":"Send buyer to payment screen","id":"send-buyer-to-payment-screen","depth":3}],"frontmatter":{"excludeFromSearch":true,"seo":{"meta":[{"name":"robots","content":"noindex"}],"title":"Postage fee"}},"lastModified":"2026-04-22T16:01:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1.0/guides/transactions/online/online-postage-fee","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}