SuperAPI AI 工具集

paypal-integration

编程与开发

查看项目

更新于 10-16 08:31

技能介绍

PayPal Integration 是一个面向开发者的支付集成技能,目标是在应用中集成 PayPal 支付处理能力,覆盖快捷结账、订阅与退款管理等场景。

在用途方面,文档给出的适用时机包括:将 PayPal 作为支付选项接入;实现快捷结账流程;设置 PayPal 定期计费;处理退款与支付争议;处理 PayPal webhook(IPN);支持国际支付;实现 PayPal 订阅。

核心概念上,技能将支付产品分为三类:PayPal Checkout(一次性支付、快捷结账体验、访客与 PayPal 账户支付)、PayPal Subscriptions(定期计费、订阅计划、自动续订)和 PayPal Payouts(向多个收款人付款、市场与平台支付)。集成方式分为两种:客户端 JavaScript SDK(智能支付按钮、托管支付流程、最少后端代码)与服务端 REST API(完全控制支付流程、自定义结账 UI、高级功能)。文档还单独说明 IPN(Instant Payment Notification):类似 webhook 的支付通知、异步支付更新、需要校验。

使用方式以示例代码呈现。前端示例通过引入 https://www.paypal.com/sdk/js?client-id=YOUR_CLIENT_ID&currency=USD 并调用 paypal.Buttons 渲染按钮,在 createOrder 中调用 actions.order.create 创建订单,在 onApprove 中调用 actions.order.capture 并在成功后通过 fetch 将 orderID 发送到后端接口 /api/paypal/capture 进行验证。后端示例使用 paypalrestsdk 配置 mode(sandbox 或 live)、client_id 与 client_secret,并定义 capture_paypal_order 函数:通过 Payment.find 查找订单,调用 payment.execute 执行支付,成功返回状态、交易 ID 与金额,失败返回错误信息。

测试部分说明使用沙箱凭据(SANDBOX_CLIENT_ID、SANDBOX_SECRET),并可在 developer.paypal.com 创建测试买家和卖家账户;示例 test_payment_flow 演示了创建订单、获取审批链接以及在人工审批后捕获订单的流程。

关于详细的模式文档,资料指出其位于 references/details.md,当上述导航层级信息不足时可阅读该文件。除此之外,资料未提供具体定价、费用、支持的完整国家或货币列表、速率限制、错误码清单以及生产环境部署限制等细节,这些内容暂未提供。