> For the complete documentation index, see [llms.txt](https://developer.magtek.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.magtek.com/resources/getting-started-with-magteks-ai-search.md). # Getting Started with MagTek's AI Search ## Stop Searching. Start Asking. **MagTek Support & Developer Site · Search** The new Magtek developer site is not just a repository of user documentation; it's designed to help you find exactly the information you need through its AI search mechanism. This is a bit different than the standard keyword searches you may be used to. The site works best when it answers questions rather than searches for words. You ask the site for information it the way you'd ask a colleague and be sure to always name the product you're working with. Here's why this changes everything. ### Two ways to search the same thing #### ❌ Keyword search — the old habit You type: > `MagneSafe decrypt` You get a stack of pages — several for products you don't own: * DynaFlex — Decrypting MagneSafe Data · `/products/dynaflex/security` * tDynamo — MagneSafe Decryption Guide · `/products/tdynamo/security` * eDynamo — Working with Encrypted Output · `/products/edynamo/dev` * MagneSafe Security Architecture Overview · `/security/magnesafe` You do the reading, the comparing, and the guessing about which page actually applies to you. #### ✅ AI search — the new habit You ask: > `How do I decrypt a MagneSafe swipe from a DynaFlex using the Universal SDK?` **Synthesized answer** For the DynaFlex, read the encrypted track data from the swipe message, then decrypt it with the device's DUKPT key using the `DecryptData()` call in the Universal SDK. The KSN travels in the same message… **You might also ask** * Where does the KSN appear in the message? * How is DynaFlex DUKPT different from tDynamo? **Sources it used** * DynaFlex — Decrypting MagneSafe Data * Universal SDK — DecryptData Reference You get an answer written for *your* device, the questions you'd ask next, and the exact in-site pages behind it — so you can open each one and verify. ### Two habits that make it work **1. Ask a question.** Write a full question, not a pile of nouns. Start with "How do I…", "Why is…", or "What's the command to…". The more it reads like a sentence, the better the answer. **2. Name the product.** Always say which reader, scanner, or SDK you mean — DynaFlex, tDynamo, eDynamo, RMS, Universal SDK. No product name, no precise answer. > **Why naming the product matters so much:** one topic — say, decrypting a swipe — has its own page for almost every device, and the steps differ in small but breaking ways. Leave the product out and the AI has to guess, or it blends instructions from hardware you don't even have. ### Rewrite a keyword into a question | Instead of typing… | Ask… | | ------------------ | ----------------------------------------------------------------------- | | `firmware update` | How do I push a firmware update to an eDynamo using RMS? | | `tap to pay setup` | How do I enable contactless tap on a tDynamo? | | `KSN error` | Why am I getting a KSN error decrypting MagneSafe data from a DynaFlex? | ### Rule of thumb If you could paste it into a message to a colleague, it's a good query. * ❌ `MagneSafe decrypt` * ✅ `How do I decrypt a MagneSafe swipe from a DynaFlex with the Universal SDK?` {% hint style="info" %} **Need Help?** For additional support, please contact MagTek Support: **Technical Support:** * 📧 **Email:** * 📞 **Phone:** 1-800-788-6835 (US) | +1-562-546-6616 (International) * 🕐 **Hours:** Monday-Friday, 6:00 AM - 5:00 PM PST **Online Resources:** * 🌐 **Official Site:** [https://www.magtek.com](https://www.magtek.com/) * 💬 **Developer Forum:** [https://forum.magtek.com](https://forum.magtek.com/) **Documentation Feedback:** Help us improve this documentation! [Submit feedback](broken://spaces/1lWLescKFIPsMeIJI6Cd/pages/5314c528980689961380bea0044c1256aaeb39bc) {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.magtek.com/resources/getting-started-with-magteks-ai-search.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.