PayPal被诟病的最主要原因之一就是糟糕的开发者体验。特别是相对Stripe而言，不仅可以定制的API少，而且API的编排逻辑和具体的介绍差的十万八千里，开发者应用起来痛苦很多。
Dev体验团队一直都有而且也认识到了差距，但是交付的速度实在是感人。改进的一些方向：
- 页面简洁化，减少不必要的图片和复杂样式，提升页面加载速度
- 注重于干货，确保可用参数覆盖与详细解释
- Navigation体验优化，更快地帮助主要用户找到想要的内容
- 提升代码用例占比，且采用双列可交互格式
- 视频或Playground模式的Demo，接地气，上手更快
- 拥抱AI，便捷化用户和AI的交互体验，因为现在开发者大多会基于AI交互来协同开发
开发者文档的演进
前两者就不提了。我们来看一下PayPal过去一年多在原始开发者文档上的试验
Navigation体验
更轻松直接的navigation体验。绝大多数开发者基本都使用checkout来做buy-now, add-to-cart或者订阅收款。确保用的最多的部分显示在最开始的位置。
示例代码体验升级
代码与文档并行展示，且文档offset和代码同步，文档按钮或者选项更改后对应渲染代码和preview改动
直观Demo触手可及
一个demo电商网站，有主页、购物车、结算页面、产品详情页面。快速看到PayPal集成的效果，浏览的过程可以通过左侧面板定制勾选支付方式等，这一点和上述dev doc类似。除此之外还有内嵌短视频演示的例子，不再赘述
AI交互
一键直达GPT，采取LLM.txt降低LLM页面处理难度。值得一提的是，dev doc search也在朝AI search的方向上靠，通过embedding-based retrieval等方式，但是效果出奇的拉，还不如google search。只能说我司进步空间实在太大。
新版网站发布
碰巧我是PayPal Merchant Integrations团队下面的，dev doc & SDK 都在org范围内，最近我们部门公开发布了新的网页，第一时间看了一下。宇宙安全声明：文档已公开，无内部信息。
技术栈
文档基于docusaurus和AIGC工具开发完成
https://docusaurus.io/docs/playground
AI first
从网站名字就看出来公司有多喜欢AI了… 里面甚至为AI Agent Toolkit & MCP Server 单独开了一个顶层tab。
前不久有幸受ld认可参与了其中的后端开发。个人感觉它的优势在于免登录（api key based）创建资源，只需要和GPT交互就能创建支付链接等。相当于你有一个私人AI秘书，给他提需求，你就能拿到一些PayPal集成用例。
具体可以参考我们5月开发者日的一些演讲 link link2
顺带吐槽一下，发觉base是相当重要，要选团队大多数人在的base才更有前途。比如要是我在圣何塞，可能上去讲的人里有我一个。
https://www.paypal.ai/
https://www.paypal.ai/docs
https://github.com/paypal/agent-toolkit
文档内容扩充中
新版文档的出现其实是为了主推AI这个话题，顺带更新docs。现在聊这个话题可能为时过早。但是能看到页面样式、图片数量减少，加载相对更快。双列API文档展示模式成功转正
总结
PayPal吸取了Stripe开发者体验上的一些优秀经验，有一些积极尝试的信号。最近明显侧重于AI这个资本狂热的领域，特别是在Agent板块。对传统的AI应用，比如AI搜索或者广告上表现仍然不足甚至是欠缺。
评论区