{"templateId":"markdown","versions":[{"version":"v1.0","label":"v1.0","link":"/docs/v1.0/intro/auth","default":false,"active":true,"folderId":"a2557b8d"},{"version":"v2.0","label":"v2.0 (latest version)","link":"/docs/intro/auth","default":true,"active":false,"folderId":"a2557b8d"}],"sharedDataIds":{"sidebar":"sidebar-docs/@v1.0/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["DSteps","DStep","admonition"]},"type":"markdown"},"seo":{"title":"Get API keys","description":"How to get started 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":"get-api-keys","__idx":0},"children":["Get API keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get started using the Trustap API, complete these steps."]},{"$$mdtype":"Tag","name":"DSteps","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"contact-trustap","__idx":1},"children":["Contact Trustap"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.trustap.com/contact-us/"},"children":["contact form"]}," get in touch with us."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To help us understand your use case, please provide the following."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"* What does your company do?\n* What problem can Trustap solve for you?\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our integration specialist will contact you as soon as possible."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"send-your-configuration-details","__idx":2},"children":["Send your configuration details"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To support your Trustap integration, our integration specialist will ask for the following details."]},{"$$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":"Integrator supplied URL"},"children":["Integrator supplied URL"]},{"$$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":["<WEBHOOK_ENDPOINT>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The URL where Trustap will send webhook events for your account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<REDIRECT_URI>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The callback URL used after ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-create-full-user"},"children":["full Trustap account creation"]},". This must match the redirect URI used in your flow. Trustap supports wildcard URIs. For example, if you provide ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://www.sams-bikes.com/*"]},", you can redirect to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://www.sams-bikes.com/login_path/"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CALLBACK_PAYMENT>"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The URL to which users are redirected after ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1.0/guides/transactions/online/online-int-path-cc#buyer-transfers-funds"},"children":["completing payment"]},". Trustap also supports wildcards here. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://www.sams-bikes.com/payment/*"]},"."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"use-your-authentication-credentials","__idx":3},"children":["Use your authentication credentials"]},{"$$mdtype":"Tag","name":"DStep","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your integration specialist will provide the credentials needed to authenticate with the Trustap API."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["API key: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<API_KEY>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Client ID: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CLIENT_ID>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Client secret: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<CLIENT_SECRET>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook username: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<WEBHOOK_USER>"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Webhook password: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<WEBHOOK_PASS>"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To make an authenticated API request, use your API key as the username in HTTP Basic Auth. Leave the password field blank."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"CURL","header":{"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\":\"sue.glass@my-mail.com\",\"first_name\":\"Sue\",\"last_name\":\"Glass\",\"country_code\":\"ca\",\"tos_acceptance\":{\"unix_timestamp\":1736441841,\"ip\":\"127.0.0.1\"}}'\n","lang":"CURL"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For basic auth authentication, API keys are provided as the \"username\" portion of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<username:password>"]},". The password field is blank. Remember to include colon (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[":"]},") as part of API key.  For example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["--user '7625348723743435:'"]},"."]}]}]}]}]},"headings":[{"value":"Get API keys","id":"get-api-keys","depth":1},{"value":"Contact Trustap","id":"contact-trustap","depth":3},{"value":"Send your configuration details","id":"send-your-configuration-details","depth":3},{"value":"Use your authentication credentials","id":"use-your-authentication-credentials","depth":3}],"frontmatter":{"seo":{"title":"Get API keys","description":"How to get started 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/intro/auth","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}