本插件基于 PayPal IPN（Instant Payment Notification）实现“个人版”在线收款能力，适用于不具备 PayPal 商业计费 SDK 的场景。插件通过标准表单方式跳转 PayPal 完成付款，并以 IPN 异步回调验证支付结果，安全落库并将订单流转为已支付。

功能特点

• 托管支付跳转：结账页“Pay with PayPal”按钮一键跳转至 PayPal 页面完成付款
• IPN 异步通知：交易完成后由 PayPal 服务器回调 IPN 接口，系统二次校验并更新订单状态
• 订单对单校验：校验 payment_status、收款邮箱、金额与币种，确保支付结果可信
• 沙箱支持：支持 PayPal Sandbox 环境便捷联调与测试
• 多语言：按钮与提示文本已接入多语言（zh-cn / en），可扩展其它语言

安装与启用

• 后台 → 插件管理 → 安装 PayPal(个人版) 插件
• 启用插件（type=payment 即可出现在结账页支付方式列表）
• 在结账页选择支付方式“PayPal(个人版)”

配置项

• 收款邮箱（business_email）：用于接收款项的 PayPal 账号邮箱
• 沙盒（sandbox）：是否启用 PayPal Sandbox 环境（是/否）

保存后生效。结账发起时会将收款邮箱与回调地址一并提交到 PayPal。

回调

• IPN 回调：POST 域名/callback/paypalipn/ipn

注册账号与沙箱测试（步骤）

PayPal 个人账号免费升级商业账号（无营业执照）+ 开通 IPN 极简步骤
全程无需营业执照，仅用个人身份信息即可完成升级，升级后账号保留个人收款属性，无年费、无额外费用，解锁完整 IPN 功能。

一、核心前提

PayPal高级账号（Premier） 目前已逐步合并至商业账号体系，直接升级商业账号（Business） 即可，流程更简单、功能无差异，且完全支持 IPN 配置。

二、步骤 1：个人账号免费升级为商业账号（无营业执照）

登录你的 PayPal 个人账号（官网入口，国内访问需用合规网络）；
点击右上角齿轮图标（设置），在左侧菜单栏找到账户与安全/账户选项（不同版本界面名称略有差异）；
找到升级为商业账号（Upgrade to a Business Account） 选项并点击；
填写升级信息（关键：无营业执照专用填写方式）：
店铺 / 企业名称：直接填写你的个人真实姓名（无需营业执照名称）；
行业 / 品类：任选（如「零售 / 个人用品」「服务 / 个人服务」）；
业务描述：简单填写（如「个人线上商品销售」「个人数字服务提供」）；
其余带 * 必填项均填写个人身份信息（与个人账户实名信息一致）；
确认信息后提交，升级即时生效，无需审核，账号自动转为商业账号，收款 / 提现规则与原个人账号一致。

三、步骤 2：升级后开通并配置 IPN（即时付款通知）

【正式环境配置（可直接用于生产）】

保持 PayPal 商业账号登录状态，点击右上角齿轮图标（设置） → 选择账户设置（Account Settings）；
左侧菜单栏点击通知（Notifications），找到即时付款通知（Instant payment notifications），点击右侧更新（Update）；
页面底部点击选择 IPN 设置（Choose IPN Settings）；
配置核心信息：
通知 URL（Notification URL）：输入你的公网可访问 IPN 回调接口地址（如域名/callback/paypalipn/ipn，需能接收 PayPal 的 POST 请求）；
勾选接收 IPN 消息（已启用）（Receive IPN messages (Enabled)）；
点击保存（Save），IPN 功能立即开通，后续所有交易 PayPal 会自动向该 URL 推送回调信息。

【沙盒测试环境配置（开发 / 调试用，可选）】

若需要先测试 IPN 逻辑，无需真实交易，可配置沙盒环境：
访问PayPal 开发者平台，用你的 PayPal 商业账号直接登录；
左侧点击Sandbox → Accounts，系统会自动生成沙盒商业账号（Business），记录账号 / 密码；
访问沙盒 PayPal 后台，用沙盒商业账号登录；
重复正式环境的 1-5 步，填写你的测试环境 IPN 回调 URL，即可完成沙盒 IPN 配置；
沙盒 IPN 专用验证地址：https://ipnpb.sandbox.paypal.com/cgi-bin/webscr?cmd=_notify-validate。

五、IPN 是否开通成功验证

登录 PayPal 商业账号，进入账户设置 → 通知 → 即时付款通知，可直接查看已启用状态；
可通过PayPal IPN 历史记录（沙盒：https://www.sandbox.paypal.com/merchantnotification/ipn/history）查看所有回调记录，包括成功 / 失败日志，可快速排查问题。

常见问题

• IPN 未回调或回调为 INVALID
  • 确认沙箱/生产开关与 PayPal 账号环境一致
  • 若使用生产，请确保站点公网可达且未被防火墙拦截
  • 检查 notify_url 是否为可访问的 HTTPS 地址
• 订单未置为已支付
  • 校验 receiver_email 是否与插件配置的收款邮箱一致