支付开发文档

1. 概述

支付采用 PaymentBundle 抽象层 + 各通道 Bundle 模式。通用交易表为 trade（OrdersBundle Entity，PaymentBundle 无独立 Entity）。

---

2. 相关 Bundle

Bundle	通道
PaymentBundle	支付开关、回调、PaymentsService
AdaPayBundle	汇付 AdaPay 开户/分账/提现
BsPayBundle	汇付斗拱
HfPayBundle	汇付天下分账/入驻
ChinaumsPayBundle	银联商务分账
IcbcPayBundle	工商银行（third 路由）

---

3. 支付流程（C 端）

创单（OrdersBundle）
  → POST /api/h5app/wxapp/payment（WxappPayment@payment）
  → 调用通道 Service 拉起支付
  → 第三方回调 POST /api/alipay/notify 等
  → 更新 trade.trade_state
  → TradeFinishEvent → 后续 Listener

---

4. 路由与代表性 API

文件	方法	路径	说明
routes/api/trade.php	GET/POST	/api/trade/payment/setting	支付开关配置
	POST	/api/alipay/notify	支付宝回调
	POST	/api/chinaums/notify	银联回调
routes/frontapi/payment.php	POST	/api/h5app/wxapp/payment	C 端发起支付
routes/api/adapay.php	GET	/api/adapay/is_open	AdaPay 是否开通
routes/api/bspay.php	POST	/api/bspay/user_indv/create	汇付斗拱进件
routes/api/hfpay.php	POST	/api/hfpay/enterapply/save	汇付入驻

核心类

• PaymentBundle\Services\PaymentsService.php
• PaymentBundle\Http\Api\V1\Action\Payment
• OrdersBundle\Http\FrontApi\V1\Action\WxappPayment

---

5. 事件与队列

项	说明
HfpayProfitSharingEvent	汇付分账
AdaPayBundle\Jobs\DrawCashJob	提现异步

---

6. 注意事项

• 通道确认单等见 adapay_paymemt_confirm 表。