{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/transactions/users","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/guides/transactions/users","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Users","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":"users","__idx":0},"children":["Users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In Trustap, users are the entities that buy and sell products or services. Every Trustap transaction requires two users: a buyer and a seller."," ","Trustap supports two types of users, Guest Users and Full Users."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Setting up user accounts can take time and create friction for users interacting with your product. To mitigate this, we use Guest Accounts to defer the registration process."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Buyers can remain guest users for the entire duration of the transaction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sellers can remain guest users for most of the transaction process but must register as full users to receive their payout."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"use-cases","__idx":1},"children":["Use cases"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"ecommerce","__idx":2},"children":["eCommerce"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For applications where the seller does not change (e.g., a standard eCommerce store), we recommend using a single Full User account for the merchant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Single Seller to Multiple Buyers"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create one Full User and retain that ID for the seller."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create Guest Users for each buyer."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"marketplaces","__idx":3},"children":["Marketplaces"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For applications with multiple sellers and multiple buyers (for example, peer-to-peer platforms)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Multiple Sellers to Multiple Buyers"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create Guest Users for both sellers and buyers initially to reduce friction."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Convert the seller to a Full User when they need to be paid out."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-users","__idx":4},"children":["Create users"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-guest-users","__idx":5},"children":["Create guest users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/apis/v1.0/openapi/buyers-and-sellers/users.createguestuser"},"children":["guest users endpoint"]}," to create a new guest user."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Create guest users","header":{"title":"Create guest users","controls":{"copy":{}}},"source":"curl --location 'https://dev.stage.trustap.com/api/v1/guest_users' \\\n--header 'Content-Type: application/json' \\\n--user '<API_KEY>:' \\\n--data-raw '{\"email\":\"sarah.garcia@shopit.com\",\"first_name\":\"Sarah\",\"last_name\":\"Garcia\",\"country_code\":\"ie\",\"tos_acceptance\":{\"unix_timestamp\":1737558834,\"ip\":\"127.0.0.1\"}}'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"JSON","header":{"controls":{"copy":{}}},"source":"{\n    \"created_at\": \"2025-01-24T15:43:20.310247061Z\",\n    \"email\": \"sara.garcia@shopit.com\",\n    \"id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\"\n}\n","lang":"JSON"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-full-users","__idx":6},"children":["Create full users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can identify full users from guest users by looking at their ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]},". A guest user id will always begin with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1-"]},". For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1-615a70d4-b624-4243-95be-a8367b7953ea"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the following guides to create full users."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-create-full-user"},"children":["Create full user for an online transaction"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/face-to-face/face-to-face-create-full-user"},"children":["Create full user for a face-to-face transaction"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"apply-users-in-a-transaction","__idx":7},"children":["Apply users in a transaction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once users are created, use the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seller_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buyer_id"]}," when creating a transaction."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Create transaction with user IDs","header":{"title":"Create transaction with user IDs","controls":{"copy":{}}},"source":"\ncurl --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\": \"Ireland vs Croatia UEFA Nations League\",\n    \"price\": 20000,\n    \"charge\": 760,\n    \"charge_calculator_version\": 5,\n    \"image_url\": \"https://docs.trustap.com/images/soccer-tickets.png\"\n}'\n","lang":"CURL"},"children":[]}]},"headings":[{"value":"Users","id":"users","depth":1},{"value":"Use cases","id":"use-cases","depth":2},{"value":"eCommerce","id":"ecommerce","depth":3},{"value":"Marketplaces","id":"marketplaces","depth":3},{"value":"Create users","id":"create-users","depth":2},{"value":"Create guest users","id":"create-guest-users","depth":3},{"value":"Create full users","id":"create-full-users","depth":3},{"value":"Apply users in a transaction","id":"apply-users-in-a-transaction","depth":2}],"frontmatter":{"excludeFromSearch":true,"seo":{"meta":[{"name":"robots","content":"noindex"}],"title":"Users"}},"lastModified":"2026-04-22T13:55:27.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1.0/guides/transactions/users","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}