AI QUICK START
00
AI 快速接入
把这份内容直接交给 AI，里面已经合并接入指南、最短接入路径和生成代码所需的提示词。
1
准备接入信息
在商户后台「个人资料 → API 信息」获取商户 ID（pid）、平台公钥与商户私钥（V2）或商户密钥（V1）；需要回调时再准备自己的 notify_url。
2
服务端发起下单
V2 按 RSA 规则签名后调用收银台下单 api/pay/submit；需要自行控制拉起方式时用 API 下单 api/pay/create；已对接易支付的可用 V1 submit.php / mapi.php（MD5）。
3
前端拉起支付
收银台下单直接 302 跳转收银台页面；API 下单根据返回的 pay_type 处理：jump 跳转、qrcode 生成二维码、jsapi 调 wx.requestPayment 等。
4
确认支付和退款结果
配置 notify_url 时处理异步回调（验签后输出 success）；未配置或回调未到时，主动调用查询订单接口。退款以退款查询结果为准。
接入方式建议：PC 和 H5 支付优先使用收银台下单；有营业执照且已有自己的支付页、需要自行控制拉起方式时，再使用 API 下单。个人小微主体直接使用收银台即可；微信小程序内支付使用
method=applet。
接入场景选择
- PC / H5 支付：使用收银台下单，跳转收银台完成支付。
- 自建支付页：使用
api/pay/create，按返回的pay_type自行拉起。 - 微信小程序：
method=applet或jsapi，返回插件 / JSAPI 参数。 - 已对接易支付：直接使用
submit.php/mapi.php（V1 MD5），零改动切换。
支付通知回调
notify_url必填；不填则平台不会发送支付通知回调。- 必须填写自己的服务器端地址，不能填写前端页面地址。
- 收到成功通知后返回纯字符串
success。 - 同一订单可能重复通知，必须按
trade_no或商户订单号做幂等。
资金与结算
- 支付成功后资金进入商户余额，按后台结算设置进行结算。
- 可通过
api.php?act=query查询商户余额与结算信息。 - 订单列表可通过
api/merchant/orders分页查询。
退款处理
- V2 申请退款：
api/pay/refund，使用商户私钥 RSA 签名。 - V1 申请退款：
api.php?act=refund，需先在后台开启「订单退款 API」。 - 退款结果以退款查询（
api/pay/refundquery）为准。
接入检查清单
这几项都具备，基本就能稳定上线。
- 商户号 pid
- 商户私钥（V2 RSA）/ 商户密钥（V1 MD5）
- 服务端下单接口
- 可选：服务端支付通知回调接口 notify_url
- 通知验签和幂等逻辑
- 订单主动查询补偿逻辑
给 AI 的完整内容
复制后可以直接生成下单签名、收银台下单、API 下单、支付回调、主动查单和退款相关代码。