{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/guides/transactions/guest-users","default":false,"active":false,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/guides/transactions/guest-users","default":true,"active":true,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Create guest users","description":"Guide on how to create a Trustap guest users.","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 like 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":[]},{"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":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"create-guest-users","__idx":0},"children":["Create guest users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guest Users allow you to initiate transactions instantly without forcing your customers through an immediate signup flow. You can create Guest Users silently on your backend as soon as a buyer hits checkout or a seller lists an item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a new guest user, send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/guest_users"]}," endpoint."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","data-title":"Create guest users","header":{"title":"Create guest users","controls":{"copy":{}}},"source":"curl -i -X POST \\\n  -u '<API_KEY>:' \\\n  'https://api.test.trustap.com/v2/guest_users' \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"email\": \"sarah.garcia@example.shop\",\n    \"first_name\": \"Sarah\",\n    \"last_name\": \"Garcia\",\n    \"country_code\": \"ie\",\n    \"tos_acceptance\": {\n      \"unix_timestamp\": 1736354931,\n      \"ip\": \"127.0.0.1\"\n    }\n  }'\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\": \"sarah.garcia@example.shop\",\n    \"id\": \"1-886e3c26-b585-4c92-a93b-e3c84b9b32e9\"\n}\n","lang":"JSON"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create-full-users","__idx":1},"children":["Create full users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guest users allow you to initiate transactions instantly without forcing your customers through an immediate signup flow. You can create guest users silently on your backend as soon as a buyer hits checkout or a seller lists an item."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To create a new guest user, send a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v2/guest_users"]}," endpoint."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"apply-users-in-a-transaction","__idx":2},"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."," ","Once you have generated your user IDs (whether they are guest IDs or full user IDs), pass them as the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buyer_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["seller_id"]}," parameters when initializing a new 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":"curl -i -X POST \\\n  -u '<API_KEY>:' \\\n  https://api.test.trustap.com/v2/transactions \\\n  -H 'Content-Type: application/json' \\\n  -d '{\n    \"amount\": 20000,\n    \"amount_extra\": 0,\n    \"buyer_id\": \"1-def29dfe-8626-48a2-8863-b6fdf2b96ff0\",\n    \"currency\": \"gbp\",\n    \"description\": \"Trustap socks\",\n    \"fees_buyer\": 640,\n    \"fees_config\": 1,\n    \"fees_seller\": 0,\n    \"image_url\": \"https://docs.trustap.com/images/trustap-socks.png\",\n    \"payment_method\": \"card\",\n    \"role\": \"seller\",\n    \"seller_id\": \"1-3f546125-2ec2-4b14-87f6-54a14ae73e98\"\n  }'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"transitioning-to-full-users","__idx":3},"children":["Transitioning to full users"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guest accounts are intended to serve as transaction placeholders to maximize your checkout conversion. Because of this architectural design, you cannot directly convert or upgrade a Guest User record into a Full User record."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a guest seller is ready to receive a payout, they must register for a completely separate full user account using our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/guides/transactions/full-users"},"children":["secure OAuth flow"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a Full User to successfully claim a transaction and receive its payout, the email address verified during the OAuth flow must exactly match the email address you assigned to the guest user when the transaction was created."]}]}]},"headings":[{"value":"Create guest users","id":"create-guest-users","depth":1},{"value":"Create full users","id":"create-full-users","depth":2},{"value":"Apply users in a transaction","id":"apply-users-in-a-transaction","depth":2},{"value":"Transitioning to full users","id":"transitioning-to-full-users","depth":2}],"frontmatter":{"title":"Create guest users","seo":{"title":"Create guest users","description":"Guide on how to create a Trustap guest users."}},"lastModified":"2026-07-17T16:18:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/guides/transactions/guest-users","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}