This is Adyen
Adyen provides payments, data, and financial products in a single solution for customers like Meta, Uber, H&M, and Microsoft - making us the financial technology platform of choice. At Adyen, everything we do is engineered for ambition.
For our teams, we create an environment with opportunities for our people to succeed, backed by the culture and support to ensure they are enabled to truly own their careers. We are motivated individuals who tackle unique technical challenges at scale and solve them as a team. Together, we deliver innovative and ethical solutions that help businesses achieve their ambitions faster.
The Role
Our Docs Excellence team is looking for a systems-minded Technical Writer to join us in Chicago. This isn't a traditional writing role: we treat technical content as structured, living knowledge rather than static pages, and you'll operate as equal parts System Builder and Technical Curator.
You'll step into an established documentation practice: existing style guidelines, a domain-based team structure, and a workflow that blends traditional technical writing with AI-assisted tooling, and you'll help evolve it further as a Knowledge Architect. As System Builder, you'll design the metadata schemas, ontology, and context rules that guide automated first-pass content generation. As Technical Curator, you'll apply exceptional editorial judgment to review, fact-check, and refine that output into precise, trustworthy, and well-structured developer documentation.
What You'll Do
- Design and maintain metadata schemas (YAML front matter), ontology, and rules that support automated, first-pass content generation workflows.
- Review, edit, and fact-check auto-generated content and code snippets for technical accuracy, edge cases, and voice.
- Author and refine API reference guides, integration workflows, and conceptual docs in a docs-as-code environment (Git, Markdown).
- Partner with Product Managers, Engineers, Support, and Implementation Managers to capture platform logic and validate merchant integration flows.
- Structure documentation so it works for two audiences at once: human developers navigating integrations, and AI systems parsing context.
Who You Are
- 3+ years documenting complex technical spaces, including APIs, SDKs, or developer platforms, with a portfolio that shows real writing and editing craft.
- Comfortable thinking beyond the page: you can design ontologies, metadata schemas, and structured information models.
- A high-judgment editor who can spot hallucinations, inaccuracies, or structural gaps in automated drafts.
- Fully fluent in Git, Markdown, and docs-as-code toolchains.
- A practical, hands-on user of AI tools and LLMs to gather context and streamline documentation work.
- Someone who asks why before executing. We value critical thinking and problem-solving as much as craft.
- Comfortable managing multiple stakeholders and adapting to a fast-moving, evolving environment.
Bonus Points
- Experience with Postman, VS Code, or similar tools.
- Basic ability to read code snippets (Java, Python, TypeScript) to verify API logic.
Team & Location
You'll join a global community of 15 writers, supported by 2 engineering teams and a senior PM across Amsterdam, Madrid, and Chicago. This role is based in our Chicago office; we operate a hybrid model (3 days/week in office).
Why Adyen?
This is an exceptional opportunity to join a solid, established company with a startup mindset, characterized by small teams, direct communication, and work on important challenges. We offer an environment of ownership and speed.
The annual base salary range for this role is $100,000 - $125,000 plus RSUs; to learn more about our compensation philosophy, please click here. This position is based out of the Chicago office.
Our Diversity, Equity and Inclusion commitments
Our unique approach is a product of our diverse perspectives. This diversity of backgrounds and cultures is essential in helping us maintain our momentum. Our business and technical challenges are unique, and we need as many different voices as possible to join us in solving them - voices like yours. No matter who you are or where you’re from, we welcome you to be your true self at Adyen.
Studies show that women and members of underrepresented communities apply for jobs only if they meet 100% of the qualifications. Does this sound like you? If so, Adyen encourages you to reconsider and apply. We look forward to your application!
What’s next?
Ensuring a smooth and enjoyable candidate experience is critical for us. We aim to get back to you regarding your application within 5 business days. Our interview process tends to take about 4 weeks to complete, but may fluctuate depending on the role. Learn more about our hiring process here. Don’t be afraid to let us know if you need more flexibility.
This role is based out of our Chicago office. We are an office-first company and value in-person collaboration; we do not offer remote-only roles.
Skills Required
- 3+ years documenting complex technical spaces, including APIs, SDKs, or developer platforms
- Portfolio demonstrating writing and editing ability
- Ability to design ontologies, metadata schemas, and structured information models
- Strong editorial judgment for identifying hallucinations, inaccuracies, and structural gaps
- Fluency in Git, Markdown, and docs-as-code toolchains
- Hands-on experience using AI tools and large language models
- Critical thinking and problem-solving skills
- Ability to manage multiple stakeholders in a fast-moving environment
- Experience with Postman, Visual Studio Code, or similar tools
- Basic ability to read Java, Python, or TypeScript code snippets to verify API logic
What the Team is Saying
.jpg)
.jpg)
Adyen Compensation & Benefits Highlights
-
Healthcare Strength — Health insurance is employer-verified and described as strong in the U.S., with medical, dental, vision, and mental‑health support highlighted. Office pages and benefits listings reinforce comprehensive core coverage alongside everyday support like onsite food and commuter options.
-
Leave & Time Off Breadth — Unlimited PTO is explicitly listed on U.S. office pages and is characterized as generous and flexible. Usage norms are noted as team‑dependent, but the policy itself is broadly positioned as a standout.
-
Flexible Benefits — A monthly Adyen+ stipend can be directed to childcare, language courses, wellness, or home‑office needs, providing unusual personalization compared with fixed perk menus. Local office pages repeatedly call out Adyen+ as a core element of the package.
Adyen Insights
What We Do
Adyen (ADYEN:AMS) is the financial technology platform of choice for leading companies. By providing end-to-end payments capabilities, data-driven insights, and financial products in a single global solution, Adyen helps businesses achieve their ambitions faster. With offices around the world, Adyen works with the likes of Meta, Uber, H&M, eBay, and Microsoft.
Why Work With Us
At Adyen, everything we do is engineered for ambition. We started with payments, at a time when providers offered services based on a patchwork of systems built on outdated infrastructure. Ambition demanded more. So we set off to build a financial technology platform for the modern era, entirely in-house, from the ground up.
Gallery
Adyen Teams
Adyen Offices
Hybrid Workspace
Employees engage in a combination of remote and on-site work.
We believe that in-person collaboration is the best route to building genuine connection. We’re an office-first company that offers flexibility when needed. We trust our team to act with autonomy and make good choices.
