{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Introduction","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":"introduction","__idx":0},"children":["Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Tilia APIs are the primary means for developers to access the Tilia resources and perform tasks such as registering users, creating invoices, and requesting payouts."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All of our APIs are based on REST architecture and are accessed via HTTPS at specified URLs. Our APIs use JSON as their communication format and the standard HTTP methods like GET, PUT, POST, and DELETE. Refer to the API Reference for the methods available for each endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn more about Tilia resources from our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/core-concepts/"},"children":["Core Concepts"]}," topics. For detailed walk-throughs to help you build your Tilia integration, refer to our ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/"},"children":["Developer Guides"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"uri-structure","__idx":1},"children":["URI Structure"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["URIs for Tilia's APIs have the following structure:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-name.environment/version/resource"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://api-name.environment/version/resource_id/resource"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In these URIs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api_name"]}," is the name of the API, for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invoicing"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accounts"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment"]}," is the Tilia environment you are working with. Staging is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["staging.tilia-inc.com"]},", while Production is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tilia-inc.com"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["version"]}," is the version of the API or endpoint. Versions are represented as the letter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v"]}," followed by the version number, for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v2"]},". Each API endpoint shows the correct version in its usage documentation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource_id"]}," is the unique identifier for the resource."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["resource"]}," is the relative path defined for the resource."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Here are some examples to illustrate the URI structure:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://accounts.staging.tilia-inc.com/register"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://accounts.tilia-inc.com/register"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payments.tilia-inc.com/v1/{account_id}/payment_methods"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://payments.staging.tilia-inc.com/v1/{account_id}/payment_methods"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All Tilia API requests must be made over HTTPS. Calls made over HTTP will fail."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"staging-environment","__idx":2},"children":["Staging Environment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Staging environment mirrors the Tilia Production environment, supporting all of the same API endpoints. Applications should be tested against the Staging environment before being used in production. Here are some key differences from the Production environment:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The Staging environment contains test data and is completely separate from your Production environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Actual money is not sent or received as part of test transactions. Real financial data should not be used in Staging."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/test-payments/"},"children":["Test payment methods"]}," may only be used in Staging."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-versions","__idx":3},"children":["API Versions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Non-breaking changes may be introduced to an existing version. Updates are versioned if those updates are considered breaking changes. You can retrieve current version information for each API by appending /info to the API's base URI, for example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET https://accounts.tilia-inc.com/info"]},"."]}]},"headings":[{"value":"Introduction","id":"introduction","depth":1},{"value":"URI Structure","id":"uri-structure","depth":2},{"value":"Staging Environment","id":"staging-environment","depth":2},{"value":"API Versions","id":"api-versions","depth":2}],"frontmatter":{"seo":{"title":"Introduction"}},"lastModified":"2026-02-05T18:12:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/api-intro","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}