{
    "componentChunkName": "component---src-templates-article-page-template-js",
    "path": "/concepts/transaction-extended-data/",
    "result": {"data":{"markdownRemark":{"frontmatter":{"title":"Transaction extended data","slug":"transaction-extended-data","updated":"2022-09-29T00:00:00.000Z","category":"concepts-extended-data","ingress":"Transaction extended data allows you to keep sensitive information stored and visible for both transaction parties, as well as add information related to, for example, integrations or analytics.","skills":null},"htmlAst":{"type":"root","children":[{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Transactions have two types of extended data. Both transaction protected\ndata and metadata are visible for the transaction participants and\noperators. Protected data can only be updated using transaction process\nactions. Transaction metadata, on the other hand, can be updated through\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/transaction-process-actions/#actionprivileged-update-metadata"},"children":[{"type":"text","value":"a privileged transaction process action"}]},{"type":"text","value":".\nIn addition, operators can update metadata either through Flex Console\nor using an\n"},{"type":"element","tagName":"a","properties":{"href":"https://www.sharetribe.com/api-reference/integration.html#update-transaction-metadata","target":"_blank","rel":["noopener","noreferrer"]},"children":[{"type":"text","value":"Integration API endpoint for updating transaction metadata"}]},{"type":"text","value":"."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"protected-data-is-updated-through-the-transaction-process","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#protected-data-is-updated-through-the-transaction-process","ariaLabel":"protected data is updated through the transaction process permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Protected data is updated through the transaction process"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Transaction protected data is visible to both transaction parties. It\ncan be updated by\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/concepts/user-extended-data/#revealing-information-within-the-transaction"},"children":[{"type":"text","value":"revealing the participants' protected data"}]},{"type":"text","value":"\nto the transaction, which renders it visible within the transaction. In\naddition, a transaction process can have an action to\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/references/transaction-process-actions/#actionupdate-protected-data"},"children":[{"type":"text","value":"update transaction protected data"}]},{"type":"text","value":"."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Protected data can be used to store any transaction specific information\nthat the users are allowed to modify. Most common use cases include\ncustomer or provider contact information, but e.g. for more complex\nmarketplace setups with several related transactions, any related\ntransaction ids can be stored in protected data."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"h2","properties":{"id":"metadata-can-be-updated-from-trusted-contexts","style":"position:relative;"},"children":[{"type":"element","tagName":"a","properties":{"href":"#metadata-can-be-updated-from-trusted-contexts","ariaLabel":"metadata can be updated from trusted contexts permalink","className":["anchor","before"]},"children":[{"type":"element","tagName":"svg","properties":{"ariaHidden":"true","focusable":"false","height":"16","version":"1.1","viewBox":"0 0 16 16","width":"16"},"children":[{"type":"element","tagName":"path","properties":{"fillRule":"evenodd","d":"M4 9h1v1H4c-1.5 0-3-1.69-3-3.5S2.55 3 4 3h4c1.45 0 3 1.69 3 3.5 0 1.41-.91 2.72-2 3.25V8.59c.58-.45 1-1.27 1-2.09C10 5.22 8.98 4 8 4H4c-.98 0-2 1.22-2 2.5S3 9 4 9zm9-3h-1v1h1c1 0 2 1.22 2 2.5S13.98 12 13 12H9c-.98 0-2-1.22-2-2.5 0-.83.42-1.64 1-2.09V6.25c-1.09.53-2 1.84-2 3.25C6 11.31 7.55 13 9 13h4c1.45 0 3-1.69 3-3.5S14.5 6 13 6z"},"children":[]}]}]},{"type":"text","value":"Metadata can be updated from trusted contexts"}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"Transaction metadata is visible to both transaction parties, but it can\nonly be updated by the operator. If your marketplace has integrations to\nthird party services whose information is transaction specific, like\ndiscount services, you can store information such as integration\nreferences or discount codes or percentages in transaction metadata.\nMetadata can also be used to tag transactions for analytics purposes."}]},{"type":"text","value":"\n"},{"type":"element","tagName":"p","properties":{},"children":[{"type":"text","value":"You need a trusted context for updating transaction metadata – either a\nprivileged transition, or a secure server endpoint. You can also build a\nseparate application to\n"},{"type":"element","tagName":"a","properties":{"href":"/docs/legacy/how-to/reacting-to-events/"},"children":[{"type":"text","value":"listen to transaction events"}]},{"type":"text","value":" and update\ntransaction metadata through the Integration API as a reaction to those\nevents."}]}],"data":{"quirksMode":false}},"headings":[{"value":"Protected data is updated through the transaction process","depth":2},{"value":"Metadata can be updated from trusted contexts","depth":2}]}},"pageContext":{"slug":"transaction-extended-data","category":"concepts-extended-data"}},
    "staticQueryHashes": ["3794076007","439097193","717698143"]}