{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/transactions/trustap-lite/listing-int-path","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/v2.0/guides/transactions/trustap-lite/listing-int-path","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["tabs","tab"]},"type":"markdown"},"seo":{"title":"Trustap lite transaction flow","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":"trustap-lite-transaction-flow","__idx":0},"children":["Trustap lite transaction flow"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-send-seller-details-to-trustap","__idx":1},"children":["Step 1: Send seller details to Trustap"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following parameters are required when creating a transaction."]},{"$$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":{"width":"20%","data-label":"Parameter"},"children":["Parameter "]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seller_email"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Valid email address of your seller. Ensure this email is correct as Trustap will send all transaction correspondence to this email."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seller_phone_number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Phone number of seller."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seller_country_code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.iban.com/country-codes"},"children":["ISO 3166-1 alpha-2 country code"]}," representing the country of your seller."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.stripe.com/currencies#presentment-currencies"},"children":["ISO 4217 three-character currency code"]}," representing the currency of the transaction."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Description of the product or service. This description is shown in all emails and payment screens."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The price of the product or service. This value must be provided in a ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.stripe.com/currencies#zero-decimal"},"children":["currency's smallest unit"]},". For example, £125 is provided as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12500"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ad_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Unique ID for the product or service. Not used by Trustap internally, but returned in webhook events."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["image_url"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["URL of the image displayed on the Trustap payment page to show your buyer the item they are paying for. Supports jpg, png, gif, bmp and svg files. Images displayed as a squares. Non-square images are cropped."]}]}]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Send seller details to Trustap","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"controls":{"copy":{}}},"source":"curl -X POST \"https://dev.stage.trustap.com/api/v1/p2p/listings/create_with_seller\" \\\n  -u \"<API_KEY>:\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"seller_email\": \"sarah.garcia@shopit.com\",\n    \"seller_phone_number\": \"34543503034\",\n    \"seller_country_code\": \"ie\",\n    \"currency\": \"eur\",\n    \"description\": \"1991 VW Golf GTI\",\n    \"value\": 10000,\n    \"ad_id\": \"588a98\",\n    \"image_url\": \"https://docs.trustap.com/images/VW-GolfGTI.jpg\"\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  \"actions_url\": \"https://actions.stage.trustap.com/f2f/transactions/24707/created_pay_deposit\"\n}\n","lang":"JSON"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-redirect-buyer-to-payment","__idx":2},"children":["Step 2: Redirect buyer to payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To start the payment flow, redirect your buyer to the payment screen using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions_url"]}," the response from ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-send-seller-details-to-trustap"},"children":["step 1"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Append a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect_uri"]}," to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions_url"]},". This ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect_uri"]}," is the URL your buyer will be directed to following payment. Your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["redirect_uri"]}," must be URL-encoded if it contains special characters."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["actions_url"]}," will look like the following."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"https://actions.stage.trustap.com/f2f/transactions/24707/created_pay_deposit?redirect_uri=https://www.my-marketplace.ie/\n","lang":"JSON"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-listen-for-a-webhook-to-disable-listing","__idx":3},"children":["Step 3: Listen for a webhook to disable listing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the buyer's payment has been confirmed, Trustap sends a webhook to the URL you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/intro/auth"},"children":["set during setup"]}," with the following payload."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n  \"code\":\"reservation_disabled\",\n  \"reservation_updated_at\":\"2025-04-31T10:10:00Z\",\n  \"metadata\": {\n      \"ad_id\": \"588a98\"\n    }\n}\n\n","lang":"JSON"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This signals that the item should be marked as unavailable."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-buyer-and-seller-transact-using-trustap","__idx":4},"children":["Step 4: Buyer and seller transact using Trustap"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your buyer and seller manage the transfer of their goods or services. Trustap provides support and protection for the buyer and seller. Trustap handles all in-transaction communication and dispute resolution."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"optional-listen-for-webhook-to-indicate-transaction-was-cancelled","__idx":5},"children":["Optional: Listen for webhook to indicate transaction was cancelled"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Trustap manage the transaction until completion. One possible outcome is the transaction is cancelled. This could be used to mark the listing as available again on the marketplace."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a transaction is cancelled, Trustap send a webhook to the URL you ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/intro/auth"},"children":["set during setup"]}," with the following payload."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n  \"code\":\"reservation_enabled\",\n  \"reservation_updated_at\":\"2025-04-31T10:10:00Z\",\n  \"metadata\": {\n      \"ad_id\": \"588a98\"\n    }\n}\n","lang":"JSON"},"children":[]}]},"headings":[{"value":"Trustap lite transaction flow","id":"trustap-lite-transaction-flow","depth":1},{"value":"Step 1: Send seller details to Trustap","id":"step-1-send-seller-details-to-trustap","depth":2},{"value":"Step 2: Redirect buyer to payment","id":"step-2-redirect-buyer-to-payment","depth":2},{"value":"Step 3: Listen for a webhook to disable listing","id":"step-3-listen-for-a-webhook-to-disable-listing","depth":2},{"value":"Step 4: Buyer and seller transact using Trustap","id":"step-4-buyer-and-seller-transact-using-trustap","depth":2},{"value":"Optional: Listen for webhook to indicate transaction was cancelled","id":"optional-listen-for-webhook-to-indicate-transaction-was-cancelled","depth":2}],"frontmatter":{"title":"Trustap lite transaction flow","description":"Steps to integrating Trustap lite","excludeFromSearch":true,"seo":{"meta":[{"name":"robots","content":"noindex"}],"title":"Trustap lite transaction flow"}},"lastModified":"2026-04-03T11:38:21.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1.0/guides/transactions/trustap-lite/listing-int-path","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}