PayPal / Stripe 在线支付 PHP 演示（中文市场）

本目录为 PHPDisk 体系下的 PHP 5.6～8.x 演示模块，与仓库根目录《PayPal整合文档.md》中的 Orders API v2（Create → Capture） 对齐，并补充 Stripe Checkout Session 创建与跳转流程。PayPal 与 Stripe 共用同一套 通用 JSON 响应（success / data / message / version），便于接入业务网关层。

程序版本号：常量 PAYMENT_DEMO_APP_VERSION（默认 inc/payment_demo_version.php；可在 config.php 覆盖）；演示页脚与 JSON 响应含 version 字段。

应用场景

跨境 SaaS、数字内容、会员订阅、工具类站点需要接入 国际卡/钱包 收款。
技术团队希望用 同一套 PHP 服务 同时验证 PayPal Orders v2 与 Stripe Checkout，再对接到自有订单系统。

用户痛点

官方文档分散，沙盒与生产、Webhook 验签、回调 URL 等配置项多，联调周期长。
各支付渠道返回结构不一致，业务层难以统一错误处理与日志。
缺少可运行的最小示例时，容易在「创建订单 → 捕获/会话完成 → 异步通知」链路上遗漏关键步骤。

本项目解决的问题

提供 无 Composer 依赖 的可部署演示：创建订单、Capture、Stripe Checkout 跳转、以及 Webhook 验签 的参考实现。
约定 统一 JSON 信封（含 version），便于网关层封装与前端/移动端消费。

项目价值说明

缩短从「读文档」到「跑通沙盒」的时间，降低接入与排错成本。
代码结构清晰，便于裁剪进现有项目或作为团队内部对接规范模板。

目录结构

路径	说明
`paypal_stripe_申请配置指南.md`	PayPal / Stripe 账号申请、密钥与 Webhook 配置说明
`config.example.php`	配置模板；复制为 `config.php`
`inc/payment_demo_version.php`	程序版本号默认值
`index.php`	演示首页（PayPal JS SDK + Stripe 按钮）
`paypal_return.php`	PayPal `return_url` 落地页，使用 `token` 执行 Capture
`checkout_stripe_success.php`	Stripe `success_url` 落地页
`inc/payment_common.php`	通用 HTTP、JSON 读写、金额格式化
`inc/paypal_api.php`	PayPal OAuth、创建订单、Capture、Webhook 验签
`inc/stripe_api.php`	Stripe Checkout Session、Webhook 签名校验
`api/paypal_create.php`	`POST` JSON，等价文档 `/api/paypal/create`
`api/paypal_capture.php`	`POST` JSON，等价文档 `/api/paypal/capture`
`api/paypal_webhook.php`	PayPal 异步通知（须配置 `PAYPAL_WEBHOOK_ID`）
`api/stripe_create_checkout.php`	`POST` JSON，创建 Checkout 并返回 `checkout_url`
`api/stripe_webhook.php`	Stripe Webhook（须配置 `STRIPE_WEBHOOK_SECRET`）

快速开始

申请与后台配置步骤见 paypal_stripe_申请配置指南.md（与仓库根目录《PayPal整合文档.md》互补：前者侧重「如何申请与填 config」，后者侧重 Orders API 与接口约定）。

将本目录部署到 Web 服务器（需启用 curl）。
复制 config.example.php 为 config.php，填写 APP_BASE_URL（无尾部斜杠）、PayPal Client ID/Secret、Stripe Secret Key。
浏览器打开 index.php，使用沙盒账号测试。

通用 JSON 约定

成功：

{ "success": true, "data": { }, "message": "" }

失败：

{ "success": false, "data": null, "message": "说明", "code": "错误码" }

参考

仓库内《PayPal整合文档.md》
PayPal Orders API v2
Stripe Checkout

Project: PHPDisk - 私有云存储解决方案
This is NOT a freeware, use is subject to license terms.
Website: https://www.phpdisk.com
Author: PHPDisk Team ( admin@phpdisk.com )
Copyright (C) 2008-2026 PHPDisk Team. All Rights Reserved.

如需定制功能，或查看更多示例与源码索引，请访问：https://code.phpdisk.com/?utm_source=paypal_stripe_payment_php_cn_sample

PayPal / Stripe 在线支付 PHP 演示（中文市场） v1.0

Screenshots

Overview

Source details