Skip to main content

Omar Abdelrazik (Adyen): Bridging the Gaps: How an Internal Developer Portal Empowers Engineering Autonomy

API The Docs 2023 Developer Success & Developer Portals Recap

This talk was presented at the API The Docs Amsterdam 2023 conference on 6-7 June. We are glad to present the video recording and the talk summary.

Visit the talk listing page for an overview of all presentations!


Omar Abdelrazik  

Team lead, Product Owner of the Internal Developer Portal at Adyen 


Omar's presentation (video recording)

“Build the portal or this platform from the user perspective.”

“It’s way better - in our experience - to only start with one thing, do it right, do it with quality, add all the custom integration with it that serves our needs, and then look at the other feature that we want to integrate.”


In the demo, you can hear about:

  • Challenges at Adyen: 
    • when a company is growing, it becomes hard to determine who is responsible for what, and
    • questions like  ‘Where can I find the API docs?’ and ‘Why did the deployment fail?’ arise.
  • Solution: one frontend to all of the internal platform offerings, which results in unifying tooling, enhances engineering autonomy (self-service), and reduces the cognitive load.
    • Backstage was a suitable framework for Adyen, mostly because of the plugins.
  • Building blocks based on needs,such as service catalog including the provided and consumed APIs. 
  • Additional challenges: service onboarding (learning curve), governance (centralizing the catalog).
  • Adyen’s plans for the future: more plugins, API support, federated search, and automatic catalog manipulation. 


  • Take a deep breath (it can be tempting to try out everything).
  • Listen to the user. 
  • Hide the complexity from users.
  • Start slow and small. 

Sign up to our Developer Portal Newsletter so that you never miss out on the latest API The Docs recaps and our devportal, API documentation and Developer Experience research publications.


Sign up


Articles on devportals, DX and API docs, event recaps, webinars, and more. Sign up to be up to date with the latest trends and best practices.