{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"TOS and KYC","description":"Tilia Wallet Developer Documentation","siteUrl":"https://thunes-tilia-docs.redocly.app/","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"tos-and-kyc","__idx":0},"children":["TOS and KYC"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All users must agree to the Tilia Terms of Service to use Tilia. The TOS are presented as part of the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/tos-flow"},"children":["TOS flow"]},", and may also be presented as a prerequisite for any other flows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Know Your Customer (KYC) is a standard verification process that ensures compliance with local regulations. To select a payout method and start receiving payments, users must submit the required personal information via the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/kyc-flow"},"children":["KYC flow"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"about-tilia-terms-of-service-tos","__idx":1},"children":["About Tilia Terms of Service (TOS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a user interacts with one of the Tilia web UIs for the first time (for example, to select a payment method), they are automatically prompted to accept the Tilia TOS. If the TOS has changed since the user last signed, they will be presented with the updated version."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the latest version of the Tilia TOS, visit ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.tilia.io/legal/tos/"},"children":["Terms of Service"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"about-know-your-customer-kyc","__idx":2},"children":["About Know Your Customer (KYC)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Users receiving funds in their Tilia wallets are required to submit KYC data, which must be validated and accepted by Tilia before funds can be recieved and/or paid out. KYC verification occurs synchronously and asynchronously, and users may need to submit their KYC details multiple times. For more information on KYC data requirements, refer to ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/kyc-flow"},"children":["KYC flow"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can check the KYC status for an account by calling our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kyc"]}," endpoint. This endpoint retrieves the state of the latest KYC information that a user had submitted. Accounts must have valid KYC data on file (KYC state must return a value of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPT"]},") to request and receive payouts."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["None of our endpoints return actual KYC data submitted by users."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"to-check-an-accounts-kyc-status","__idx":3},"children":["To check an account's KYC status"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Another version of this information is available"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you're new to Tilia services, a newer version of this information is available in the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/tutorials/user-accounts"},"children":["User Accounts Tutorials"]}," section of these docs, which might be an easier place to start."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Checking KYC status requires an API token with the scope ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["read_kyc"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"curl --location --request GET https://pii.tilia-inc.com/v1/kyc/{account_id} \\\n--header 'Authorization: Bearer <Access_Token>' \\\n--header 'Content-Type: application/json' \\\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"sample-response","__idx":4},"children":["Sample response"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Success\",\n    \"message\": [],\n    \"codes\": [],\n    \"payload\": {\n        \"account_id\": \"09c9e3ee-8af5-4206-a395-13bba43e4fa2\",\n        \"state\": \"ACCEPT\"\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Possible values for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}," are:"]},{"$$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":"Value"},"children":["Value"]},{"$$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":["NODATA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No information has been collected for the account"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NONE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Information has been successfully collected for tax purposes, KYC has not been run."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PROCESSING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["KYC data is being actively processed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The account's KYC data has been verified."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MANUAL_REVIEW"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The account's KYC data is under manual review by the Tilia Compliance Team."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DENY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The account's KYC data has been rejected."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CANCEL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tilia's Compliance Team reached out to the user for more info and never received a response. User can submit new KYC application."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SYSTEM-CANCELLED"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Application cancelled by the system due to incorrect or incomplete information provided. User can submit a new KYC application."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REVERIFY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["(Legacy) User needs to resubmit a new KYC application."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the Staging Environment, KYC data is automatically approved. Thus, after completing the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/web-uis/kyc-flow"},"children":["KYC flow"]},", the value for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["state"]}," will always be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ACCEPT"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For information on how personal data is used, visit our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://www.tilia.io/legal/privacy/"},"children":["Privacy Policy"]},"."]}]},"headings":[{"value":"TOS and KYC","id":"tos-and-kyc","depth":1},{"value":"About Tilia Terms of Service (TOS)","id":"about-tilia-terms-of-service-tos","depth":3},{"value":"About Know Your Customer (KYC)","id":"about-know-your-customer-kyc","depth":3},{"value":"To check an account's KYC status","id":"to-check-an-accounts-kyc-status","depth":3},{"value":"Sample response","id":"sample-response","depth":4}],"frontmatter":{"seo":{"title":"TOS and KYC"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/tos-and-kyc","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}