In this talk, we are going to explain what we did @ MODO (a new mobile payment solution similar to Bizum) to develop from the ground up a single platform that provides multiple functionalities to the biggest banks in Argentina, using OpenAPI/Swagger and a design-first approach.

1. HOW TO DEVELOP AN
API ECOSYSTEM FOR
THE FINTECH INDUSTRY
FROMTHEGROUNDUP
nanovazquez.dev
@nanovazquez__
1

2. Full-stack developer (15+ years)
International speaker
Engineering Director @
Microsoft MVP & Co-organizer of
conferences & meetups (ReactBA,
vOpen, DevDayAr)
A LITTLE BIT ABOUT MYSELF
2

3. SCENARIO
WHATIS ?
3 . 1

4. We integrate private,
public and co-operative
banks
3 . 2

5. 2020
3 . 3

6. “ ISTHEFIRSTTECHSOLUTIONIN
ARGENTINATHATINTEGRATESALLBANKS
INASINGLEAPP
3 . 4

7. HOW TO DESIGN A SOLUTION
A.K.A.WHATWEINITIALLYDID
4 . 1

8. USE CASES TO IMPLEMENT
Onboard users to the platform
Send & receive money to & from friends
Pay with a QR code in a shop
. . .
4 . 2

9. “ WEUSEDOPENAPIANDSWAGGER
ASTHECOMMONPLACEFOROURAPI
ECOSYSTEMDOCS
4 . 3

10. SWAGGER + OPEN API
“ Swagger is an open source software
framework backed by a broad ecosystem of tools
that helps developers design, build, document,
standardize and consume RESTful Web services.
“ The OpenAPI Specification, originally known
as the Swagger Specification, is a specification for
machine-readable interface files for describing,
producing, consuming, and visualizing RESTful
web services.
4 . 4

11. Automated
docs portal
A mocked
service
Code
generation
4 . 5

12. Automated
docs portal
A mocked
service
Code
generation
4 . 5

13. Automated
docs portal
A mocked
service
Code
generation
4 . 5

14. Automated
docs portal
A mocked
service
Code
generation
4 . 5

15. LESSON LEARNED
LESSON LEARNED
4 . 6

16. LESSON LEARNED
LESSON LEARNED
SOMETHING WRONG OR MISSING? BREAK EVERYTHING!
#1
4 . 6

17. LESSON LEARNED
LESSON LEARNED
SOMETHING WRONG OR MISSING? BREAK EVERYTHING!
#1
INTEGRATE AS SOON AS POSIBLE
#2
4 . 6

18. “ WITHTHISINPLACE,WERELEASED
ONDECEMBER2020🎉
4 . 7

19. ECOSYSTEM V1.0
WEAREGA,NOWWHAT?
5 . 1

20. “ ISTHEFIRSTTECHSOLUTIONIN
ARGENTINATHATINTEGRATESALLBANKS
INASINGLEPLATFORM
5 . 2

21. “ TOP-D0WNAPPROACHESAREGREAT
FORTHEBEGINNING,BUTHARDERTO
MAINTAIN
5 . 3

22. NO BREAKING CHANGES
3 VERSIONS OF THE API similar to what node.js does
5 . 4

23. BETTER COMMUNICATION
OPEN & BIDIRECTIONAL and automated (as possible)
5 . 5

24. DOGFOODING
TEST OUR STUFF
puting on the client's hat (and
reducing friction between teams)
5 . 6

25. “ WEARETODAYBUILDINGTHE
FOUNDATIONOFALIVEECOSYSTEM,
EVOLVINGTOGETHER
5 . 7

26. ECOSYSTEM
PLANNEDEVOLUTION
6 . 1

27. SOLID FOUNDATIONS
6 . 2

28. SOLID FOUNDATIONS
KEY STAKEHOLDERS AS FEATURE CHAMPIONS (BETA TESTERS)
#1
6 . 2

29. SOLID FOUNDATIONS
KEY STAKEHOLDERS AS FEATURE CHAMPIONS (BETA TESTERS)
#1
NEWSLETTERS: FROM EMAILS TO REDUCED AUDIENCES TO ALL
#2
6 . 2

30. SOLID FOUNDATIONS
KEY STAKEHOLDERS AS FEATURE CHAMPIONS (BETA TESTERS)
#1
NEWSLETTERS: FROM EMAILS TO REDUCED AUDIENCES TO ALL
#2
IMPROVED ECOSYSTEM: NOTIFICATIONS VIA EVENTS
#3
6 . 2

31. SOLID FOUNDATIONS
KEY STAKEHOLDERS AS FEATURE CHAMPIONS (BETA TESTERS)
#1
NEWSLETTERS: FROM EMAILS TO REDUCED AUDIENCES TO ALL
#2
IMPROVED ECOSYSTEM: NOTIFICATIONS VIA EVENTS
#3
PUBLIC ROADMAP & ORGANIZE WORK WITH INITIATIVES/THEMES
#4
6 . 2

32. “ WEDON'THAVEALLTHEANSWERS,
BUTFORSUREIT'SGOINGTOBEA
GREATRIDE
6 . 3

33. THANKS!
QUESTIONS? @NANOVAZQUEZ__
7