{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/transactions/online/online-shipping","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/v2.0/guides/transactions/online/online-shipping","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["DSteps","DStep","admonition","tabs","tab","ConfigurableTabs","ConfigurableTab","img"]},"type":"markdown"},"seo":{"title":"Online integrated shipping","description":"Guide to enabling integrated shipping using the Trustap API.","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":"online-integrated-shipping","__idx":0},"children":["Online integrated shipping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use the Trustap API to generate and purchase shipping labels. Trustap uses ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.goshippo.com"},"children":["Shippo"]}," to generate shipping labels. These shipping labels can be printed by sellers, attached to parcels, and used to transport items to a buyer."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following flow to add shipping to an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-int-path-cc"},"children":["online transaction"]},"."]},{"$$mdtype":"Tag","name":"DSteps","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-sellers-and-buyers","__idx":1},"children":["Create a sellers and buyers"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Follow our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/users"},"children":["users"]}," guide to create user IDs for both seller and buyer."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-trustap-fee-charge","__idx":2},"children":["Get Trustap Fee (Charge)"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before creating a transaction, retrieve the charge for the transaction. This returns the cost for using the Trustap service for this transaction."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price"]}," is an integer, in which the last 2 digits are the decimal part of the price. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price:1050"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency:eur"]}," = 10,50€."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Get Trustap fee","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=20000&currency=gbp' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"charge\": 760,\n    \"charge_calculator_version\": 3,\n    \"charge_config\": 1,\n    \"charge_seller\": 0,\n    \"currency\": \"gbp\",\n    \"payment_method\": \"card\",\n    \"price\": 20000\n}\n","lang":"json"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-a-transaction","__idx":3},"children":["Create a transaction"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable shipping for a transaction, include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["use_shippo"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["require_seller_acceptance"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["features"]}," when creating the transaction."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"\"features\": [\"use_shippo\", \"require_seller_acceptance\"]\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Create transaction including shipping","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 'Trustap-User: 1-886e3c26-b585-4c92-a93b-e3c84b9b32e9' \\\n--header 'Content-Type: application/json' \\\n--user '<API_KEY>:' \\\n--data '{\n\"seller_id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\",\n\"buyer_id\": \"1-615a70d4-b624-4243-95be-a8367b7953ea\",\n\"creator_role\": \"seller\",\n\"currency\": \"gbp\",\n\"description\": \"Online no deposit\",\n\"price\": 20000,\n\"charge\": 720,\n\"charge_calculator_version\": 5,\n\"payment_method\": \"card\",\n\"features\": [\"use_shippo\", \"require_seller_acceptance\"]\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n        \"buyer_id\": \"1-615a70d4-b624-4243-95be-a8367b7953ea\",\n        \"charge\": 720,\n        \"charge_seller\": 0,\n        \"client_id\": \"118931fb-e3fc-44fc-8a86-06a79d26972c\",\n        \"created\": \"2025-03-19T09:55:36Z\",\n        \"currency\": \"gbp\",\n        \"description\": \"Online no deposit\",\n        \"id\": 25439,\n        \"is_payment_in_progress\": false,\n        \"joined\": \"2025-03-19T09:55:36Z\",\n        \"price\": 20000,\n        \"quantity\": 1,\n        \"seller_id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\",\n        \"status\": \"joined\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-sender-address","__idx":4},"children":["Add sender address"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add your sender`s address. To receive an accurate shipping rate estimation, it is important to use an accurate address."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},", use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements"},"children":["ISO 3166-1 alpha-2 country codes"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["While not required, some shipping carriers may need an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," addresses for both your seller and buyer. Add these when adding addresses."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Add sender address","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_address' \\\n--user '<API_KEY>:' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"city\": \"London\",\n  \"country\": \"GB\",\n  \"full_name\": \"Sarah Garcia\",\n  \"phone\": \"4215559099\",\n  \"state\": \"London\",\n  \"street_1\": \"12 Abercrombie Rd\",\n  \"zip_code\": \"E20 3AB\",\n  \"email\":\"sarah.garcia@shopit.com\",\n  \"is_sender_address\": true\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n    \"city\": \"London\",\n    \"country\": \"GB\",\n    \"full_name\": \"Sarah Garcia\",\n    \"phone\": \"4215559099\",\n    \"state\": \"London\",\n    \"street_1\": \"12 Abercrombie Rd\",\n    \"zip_code\":\"E20 3AB\",\n    \"email\":\"sarah.garcia@shopit.com\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-recipient-address","__idx":5},"children":["Add recipient address"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add your recipient`s address. It is important to use an accurate address to avoid issues in shipping rate estimation and parcel delivery."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]},", use ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements"},"children":["ISO 3166-1 alpha-2 country codes"]},"."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Add recipient address","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_address' \\\n--user '<API_KEY>:' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"city\": \"Manchester\",\n  \"country\": \"GB\",\n  \"full_name\": \"Bert Gray\",\n  \"phone\": \"123456789\",\n  \"zip_code\": \"M11 4DQ\",\n  \"state\": \"Manchester\",\n  \"street_1\": \"42 Stuart St\",\n  \"email\":\"bert.gray@my-mail.com\",\n  \"is_sender_address\": false\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n  \"city\": \"Manchester\",\n    \"country\": \"GB\",\n    \"full_name\": \"Bert Gray\",\n    \"phone\": \"123456789\",\n    \"zip_code\":\"M11 4DQ\",\n    \"state\": \"Manchester\",\n    \"street_1\": \"42 Stuart St\",\n    \"email\":\"bert.gray@my-mail.com\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"add-parcel-details","__idx":6},"children":["Add parcel details"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Add parcel details. These are the physical characteristics of your parcel. It's important to use accurate parcel details as they are used to determine the most appropriate shipping options for your parcel."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Add parcel details","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_parcel_details' \\\n--user '<API_KEY>:' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"distance_unit\": \"cm\",\n  \"height\": 10,\n  \"length\": 10,\n  \"mass_unit\": \"lb\",\n  \"weight\": 10,\n  \"width\": 10,\n  \"shipment_date\": \"2025-11-18T00:35:03.463Z\"\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n  \"distance_unit\": \"cm\",\n  \"height\": 10,\n  \"lenght\": 10,\n  \"mass_unit\": \"lb\",\n  \"weight\": 10,\n  \"width\": 10,\n  \"shipment_date\": \"2025-11-18T00:35:03.463Z\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"declare-customs-for-shipment","__idx":7},"children":["Declare customs for shipment"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A customs declaration is a record of the details about the contents of a parcel. For international shipping, this is required. It ensures compliance with import and export regulations and helps determine duties, taxes, and restrictions."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Add customs details","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_customs_declaration' \\\n--user '<API_KEY>:' \\\n--header 'Content-Type: application/json' \\\n--data '{\n  \"certify\": true,\n  \"certify_signer\": \"Bert Gray\",\n  \"description\": \"T-Shirt\",\n  \"incoterm\": \"DDU\",\n  \"mass_unit\": \"lb\",\n  \"net_weight\": 10,\n  \"non_delivery_option\": \"return\",\n  \"origin_country\": \"GB\",\n  \"quantity\": 1,\n  \"value_amount\": \"200\",\n  \"value_currency\": \"GBP\"\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For international shipments, the customs details are added to the shipment. These are printed on the label where appropriate."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This example is shipment within the UK so a customs declaration is not required. The follow response is expected when a customs declaration is not required."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n  \"code\": \"nothing_to_declare\",\n  \"error\": \"sender's and recipient's address are within the same custom union area\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"find-shipping-options","__idx":8},"children":["Find shipping options"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Find shipping rates available to ship the seller's parcel."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Request shipping rates","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_shipping_rates' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"[\n  {\n  \t\"amount\": \"6.14\",\n  \t\"amount_local\": \"6.14\",\n  \t\"attributes\": [],\n  \t\"currency\": \"GBP\",\n  \t\"currency_local\": \"GBP\",\n  \t\"duration_terms\": \"\",\n  \t\"estimated_days\": 0,\n  \t\"id\": \"1621f20647db4bc1a1b8ba9297b64305\",\n  \t\"provider\": \"Hermes UK\",\n  \t\"provider_image\": \"https://shippo-static.s3.amazonaws.com/providers/200/myHermes.png\"\n  },\n  {\n  \t\"amount\": \"5.27\",\n  \t\"amount_local\": \"5.27\",\n  \t\"attributes\": [\n  \t\t\"CHEAPEST\"\n  \t],\n  \t\"currency\": \"GBP\",\n  \t\"currency_local\": \"GBP\",\n  \t\"duration_terms\": \"\",\n  \t\"estimated_days\": 0,\n  \t\"id\": \"417bb46e734c457e97316122081cf99f\",\n  \t\"provider\": \"Hermes UK\",\n  \t\"provider_image\": \"https://shippo-static.s3.amazonaws.com/providers/200/myHermes.png\"\n  },\n  {\n  \t\"amount\": \"5.38\",\n  \t\"amount_local\": \"5.38\",\n  \t\"attributes\": [],\n  \t\"currency\": \"GBP\",\n  \t\"currency_local\": \"GBP\",\n  \t\"duration_terms\": \"\",\n  \t\"estimated_days\": 0,\n  \t\"id\": \"81a9a7ed99bc4f508a4edba72e51dee6\",\n  \t\"provider\": \"DPD UK\",\n  \t\"provider_image\": \"https://shippo-static.s3.amazonaws.com/providers/200/DPD.png\"\n  }\n]\n\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"select-shipping-option-and-add-to-transaction","__idx":9},"children":["Select shipping option and add to transaction"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Select a rate returned from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["shippo_shipping_rates"]}," using the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," of your preferred rate."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Add shipping rate to transaction","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location --globoff 'https://dev.stage.trustap.com/api/v1/transactions/25439/shippo_shipping_rate' \\\n--header 'Trustap-User: 1-886e3c26-b585-4c92-a93b-e3c84b9b32e9' \\\n--header 'Content-Type: application/json' \\\n--user '<API_KEY>:'\\\n--data '{\n    \"rate_id\": \"417bb46e734c457e97316122081cf99f\"\n}'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["204"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"buyer-transfers-funds","__idx":10},"children":["Buyer transfers funds"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a transaction is created, the buyer should be redirected to the payment page to pay for it."," ","The cost of the transaction includes both the Trustap fee and shipping fee."]},{"$$mdtype":"Tag","name":"ConfigurableTabs","attributes":{"id":"payment-method","urlParam":"payment"},"children":[{"$$mdtype":"Tag","name":"ConfigurableTab","attributes":{"label":"Card payment","value":"card","default":true},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment URL that you send to the buyer depends on your type of integration."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the following examples, replace ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CALLBACK_PAYMENT>"]}," with the redirect URI you set ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/intro/auth"},"children":["during your Trustap setup"]},". This is the location where the buyer will be redirected to following payment."]}]},{"$$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":"Use case"},"children":["Use case"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"URL"},"children":["URL"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Test environment - Guest buyer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://actions.stage.trustap.com/online/transactions/{transaction_id}/guest_pay?redirect_uri=<CALLBACK_PAYMENT>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Test environment - Full user buyer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://actions.stage.trustap.com/online/transactions/{transaction_id}/pay?redirect_uri=<CALLBACK_PAYMENT>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production environment - Guest buyer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://actions.trustap.com/online/transactions/{transaction_id}/guest_pay?<CALLBACK_PAYMENT>"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Production environment - Full user buyer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://actions.trustap.com/online/transactions/{transaction_id}/pay?<CALLBACK_PAYMENT>"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For example:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"cURL","header":{"controls":{"copy":{}}},"source":"https://actions.stage.trustap.com/online/transactions/25439/guest_pay?redirect_uri=https://www.example.com\n","lang":"cURL"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The payment screen looks like the following."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/online-payment-shipping.3337973a4d65a06de46d1bd09e4c2150591a39bcb13498735e0a8dcf56f3ce93.df2da560.png","alt":"Image with dimensions","withLightbox":true,"width":600},"children":[]}]},{"$$mdtype":"Tag","name":"ConfigurableTab","attributes":{"label":"Bank transfer","value":"bank","default":false},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Ensure, you have following configured."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-create-buyers-sellers-and-calculate-charges"},"children":["Calculate charge"]}," to include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payment_method=bank_transfer"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-2-create-a-transaction"},"children":["Transaction creation"]}," to include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"payment_method\": \"bank_transfer\""]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guide your buyer to pay using the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-9-buyer-transfers-funds"},"children":["Trustap payment screen"]},"."," ","Instead of card payment details, your buyer will be shown bank transfer details after they submit their personal details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Alternatively, you can use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/online-payment/basic.getbanktransferdetails"},"children":["bank details endpoint"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Get the bank details","header":{"title":"Get the bank details","controls":{"copy":{}}},"source":"  curl --location 'https://dev.stage.trustap.com/api/v1/transactions/{transaction_id}/bank_transfer_details' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response includes all the details needed for a buyer to complete the transaction over a bank transfer."," ","Use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hosted_instructions_url"]}," to share instructions on how to use the bank details."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","data-title":"Bank details response","header":{"title":"Bank details response","controls":{"copy":{}}},"source":"{\n  \"amount\": 0,\n  \"currency\": \"string\",\n  \"financial_address\": {\n    \"aba\": {\n      \"account_number\": \"string\",\n      \"bank_name\": \"string\",\n      \"routing_number\": \"string\"\n    },\n    \"iban\": {\n      \"account_holder_name\": \"string\",\n      \"bic\": \"string\",\n      \"country\": \"string\",\n      \"iban\": \"string\"\n    },\n    \"sort_code\": {\n      \"account_holder_name\": \"string\",\n      \"account_number\": \"string\",\n      \"sort_code\": \"string\"\n    },\n    \"swift\": {\n      \"account_number\": \"string\",\n      \"bank_name\": \"string\",\n      \"swift_code\": \"string\"\n    }\n  },\n  \"hosted_instructions_url\": \"string\",\n  \"reference\": \"string\"\n}\n\n","lang":"JSON"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["There is another option for displaying account details. To display an option for card payment or bank transfer follow these steps."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set payment method to bank transfer as above."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follow the steps in card payment."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the buyer is directed to the card payment screen, they will see the option for card payment or bank transfer."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"seller-accepts-payment","__idx":11},"children":["Seller accepts payment"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The seller must accept the payment. At this point, the shipping label is purchased."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Accept payment for seller","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location --globoff --request POST 'https://dev.stage.trustap.com/api/v1/transactions/25439/accept_payment_with_guest_seller' \\\n--header 'Trustap-User: 1-886e3c26-b585-4c92-a93b-e3c84b9b32e9' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n    \"buyer_id\": \"1-615a70d4-b624-4243-95be-a8367b7953ea\",\n    \"charge\": 720,\n    \"charge_postage_buyer\": 527,\n    \"charge_postage_client\": 0,\n    \"charge_seller\": 0,\n    \"client_id\": \"118931fb-e3fc-44fc-8a86-06a79d26972c\",\n    \"created\": \"2025-03-19T10:37:48Z\",\n    \"currency\": \"gbp\",\n    \"description\": \"Online no deposit\",\n    \"id\": 25439,\n    \"is_payment_in_progress\": false,\n    \"joined\": \"2025-03-19T10:37:48Z\",\n    \"paid\": \"2025-03-19T10:47:03Z\",\n    \"payment_accepted\": \"2025-03-19T10:51:02Z\",\n    \"price\": 20000,\n    \"quantity\": 1,\n    \"seller_id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\",\n    \"status\": \"tracked\",\n    \"tracked\": \"2025-03-19T10:51:04Z\",\n    \"tracking\": {\n            \"carrier\": \"Hermes UK\",\n            \"tracking_code\": \"P1234567890123456\"\n    },\n    \"tracking_details_deadline\": \"2025-03-23T10:51:02Z\",\n    \"tracking_details_window_started\": \"2025-03-19T10:51:02Z\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-shipping-label","__idx":12},"children":["Get Shipping label"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The shipping label is available to download, print, and attach to the parcel using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["label_url"]},". Tracking details are also available through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_code"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tracking_url"]},"."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Get Shipping label","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl --location --globoff 'https://dev.stage.trustap.com/api/v1/transactions/25372/shippo_shipping_label' \\\n--header 'Trustap-User: 1-615a70d4-b624-4243-95be-a8367b7953ea' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n        \"label_url\": \"https://shippo-delivery.s3.amazonaws.com/96.pdf?Signature=PEdWrp0mFWAGwJp7FW3b%2FeA2eyY%3D&Expires=1385930652&AWSAccessKeyId=AKIAJTHP3LLFMYAWALIA\",\n        \"tracking_code\": \"P1234567890123456\",\n        \"tracking_url\": \"https://www.evri.com/track/parcel/P1234567890123456\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"delivery-to-buyer-is-confirmed","__idx":13},"children":["Delivery to buyer is confirmed"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the Trustap API receives confirmation from the carrier that the parcel has been delivered, delivery will automatically be confirmed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Optionally, the buyer or the seller can manually confirm delivery."]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Buyer confirms delivery","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"    curl --location --globoff --request POST 'https://dev.stage.trustap.com/api/v1/transactions/25372/confirm_delivery_with_guest_buyer' \\\n    --header 'Trustap-User: 1-615a70d4-b624-4243-95be-a8367b7953ea' \\\n    --user '<API_KEY>:' \\\n","lang":"CURL"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Response","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n    \"buyer_id\": \"1-615a70d4-b624-4243-95be-a8367b7953ea\",\n    \"charge\": 720,\n    \"charge_postage_buyer\": 527,\n    \"charge_postage_client\": 0,\n    \"charge_seller\": 0,\n    \"client_id\": \"118931fb-e3fc-44fc-8a86-06a79d26972c\",\n    \"complaint_period_deadline\": \"2025-03-19T11:01:35Z\",\n    \"created\": \"2025-03-19T10:37:48Z\",\n    \"currency\": \"gbp\",\n    \"delivered\": \"2025-03-19T10:56:35Z\",\n    \"description\": \"Online no deposit\",\n    \"id\": 25439,\n    \"is_payment_in_progress\": false,\n    \"joined\": \"2025-03-19T10:37:48Z\",\n    \"paid\": \"2025-03-19T10:47:03Z\",\n    \"payment_accepted\": \"2025-03-19T10:51:02Z\",\n    \"price\": 20000,\n    \"quantity\": 1,\n    \"seller_id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\",\n    \"status\": \"delivered\",\n    \"tracked\": \"2025-03-19T10:51:04Z\",\n    \"tracking\": {\n            \"carrier\": \"Hermes UK\",\n            \"tracking_code\": \"P1234567890123456\"\n    },\n    \"tracking_details_deadline\": \"2025-03-23T10:51:02Z\",\n    \"tracking_details_window_started\": \"2025-03-19T10:51:02Z\"\n}\n","lang":"JSON"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"complaints-period","__idx":14},"children":["Complaints period"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["At this point, the buyer has an option to create a complaint. This means that were not satisfied with the transaction. A complaint will pause any payout until the dispute has been resolved."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See our guide to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/complaint"},"children":["create a complaint"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"seller-claims-transaction","__idx":15},"children":["Seller claims transaction"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A seller must register for a full Trustap account before they can claim a transaction. See our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/full-users"},"children":["full user guide"]}," for details."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Using the seller full Trustap account user ID as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Trustap-User"]},", claim the transaction. This links the transaction to their full Trustap account."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Seller claims transaction","header":{"title":"Seller claims transaction","controls":{"copy":{}}},"source":"curl --location --request POST 'https://dev.stage.trustap.com/api/v1/transactions/25273/claim_for_seller' \\\n--header 'Trustap-User: b9c9e108-1edd-5d5e-8268-8873d7beb3e3' \\\n--user '<API_KEY>:'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"ol","attributes":{"start":3},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Following confirmation of delivery and a successful complaints period, the seller will receive the payout from the transaction to their account."]}]}]}]}]},"headings":[{"value":"Online integrated shipping","id":"online-integrated-shipping","depth":1},{"value":"Create a sellers and buyers","id":"create-a-sellers-and-buyers","depth":3},{"value":"Get Trustap Fee (Charge)","id":"get-trustap-fee-charge","depth":3},{"value":"Create a transaction","id":"create-a-transaction","depth":3},{"value":"Add sender address","id":"add-sender-address","depth":3},{"value":"Add recipient address","id":"add-recipient-address","depth":3},{"value":"Add parcel details","id":"add-parcel-details","depth":3},{"value":"Declare customs for shipment","id":"declare-customs-for-shipment","depth":3},{"value":"Find shipping options","id":"find-shipping-options","depth":3},{"value":"Select shipping option and add to transaction","id":"select-shipping-option-and-add-to-transaction","depth":3},{"value":"Buyer transfers funds","id":"buyer-transfers-funds","depth":3},{"value":"Seller accepts payment","id":"seller-accepts-payment","depth":3},{"value":"Get Shipping label","id":"get-shipping-label","depth":3},{"value":"Delivery to buyer is confirmed","id":"delivery-to-buyer-is-confirmed","depth":3},{"value":"Complaints period","id":"complaints-period","depth":3},{"value":"Seller claims transaction","id":"seller-claims-transaction","depth":3}],"frontmatter":{"seo":{"title":"Online integrated shipping","description":"Guide to enabling integrated shipping using the Trustap API.","meta":[{"name":"robots","content":"noindex"}]},"excludeFromSearch":true},"lastModified":"2026-04-22T13:55:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1.0/guides/transactions/online/online-shipping","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}