Guides and reports

Our docs are nominated for the 2020 DevPortal Awards!

By Andrea Szollossi, Technical Writer, Adyen

October 8, 2020
 ·  4 minutes
vote for us

For the second year in a row, the Adyen documentation and API Explorer arenominated for the DevPortal Awards. The DevPortal Awards are a way for the API community to recognize, celebrate and learn from the world’s greatest developer portals and their API documentation.

You can help us win the award for the Best Overall Developer Portal -- register andvote for usbefore 31 October!

We’ve set a high bar for ourselves 🏅🏅

Last year, we won two DevPortal awards. OurAPI Explorerwas awarded the Best API Reference Documentation for innovation and ease of use. TheAdyen documentationwas awarded the Best Decision Maker Documentation for content and UX improvements that help create a unified experience across our online resources.

So where do we go from here? In the last year we’ve been working hard on improving developer experience but also on improving our less technical content.

Better onboarding for everyone 🙌

Everyone’s a beginner when faced with a new API. Because Adyen integrations are built on powerful APIs, we focused on making sure developers can quickly get to that first successful API call. Because a lot of developers learn by breaking things, we’ve built and documentedexample payments integrations, complete with a functioning ecommerce website!

To give our merchants the confidence that their integration is ready to accept live payments, we are using the power of checklists. For example, our go-live checklist for online payments integrationslists all the things our merchants need to tick off before going live.

We know from research that developers are not the only users of our portal. Setting up a payments integration also involves people working on compliance, reporting, and risk management. To help our merchants plan their integration work efficiently across disciplines, we published astep-by-step overview of the whole process.

People have different content preferences, so we’ve also been working on alternative ways of getting people familiar with how Adyen works. For example, our page aboutmanaging paymentsthrough the Customer Area dashboard, has the same content in both text and video format.

Helping users make the right choices 🤔

Making choices is hard, and Adyen offers a lot of choices for integrating. To avoid choice overload, the documentation helps merchants make the right choices for their business. To help merchants navigate the complex topic of in-store refundsfor example, we give clear contextual information, and use cases for the available options.

Compliance can be very intimidating, especially for merchants without in-house expertise. We published acompliance guideso our merchants know which requirements they need to meet for their Adyen integration type.

We've also been working on making sure our APIs are intuitive for our end-users. Despite the pandemic, we organised virtual feedback sessions on topics related to API design and community engagement.

Improving our API reference and documentation 📃

Last year, we won the award for Best API Reference documentation. Not wanting to rest on our laurels, we stepped up our game even more in 2020.

Few things are more upsetting than an example code block that doesn’t work -- both for the developer and for the writer! By working onautomating and testingthe code samples in our documentation, we make sure our users have code snippets that work, and our writers spend a lot less time creating and maintaining those snippets.

To make it easier to stay up to date, we revised our online payments release notes, which include updates about the APIs as well as the web and mobile integration components. Following feedback from the community, we also set up a monthlydeveloper newsletterso people can get the updates directly in their inboxes.

Vote for us! ✅

You can help us win the award for the Best Overall Developer Portal!

Register andvote for usbefore 31 October. The winners are announced on 25 November.

Technical careers at Adyen

We are on the lookout for talented engineers and technical people to help us build the infrastructure of global commerce!

Check out developer vacancies

Developer newsletter

Get updated on new blog posts and other developer news.

Subscribe now



Fresh insights, straight to your inbox

By submitting your information you confirm that you have read Adyen's Privacy Policy and agree to the use of your data in all Adyen communications.