打开支付宝设置
使用能保存瓜奇设置的后台账号,进入「支付」→「支付宝」,打开「启用此支付方式」。填写前台展示信息,并在「支持的货币」中选择业务使用的币种。
「支付渠道」当前有官方支付宝、虎皮椒和易支付。先选渠道,再填写对应资料;三种渠道使用的凭据不同。
接入官方支付宝
先在支付宝开放平台准备应用,确认所需支付产品已可用。应用入口参见支付宝网页与移动应用。
- 将「支付渠道」设为「官方支付宝」。
- 填写该应用的「App ID」。
- 在「应用私钥」中填写用于签名的私钥内容,在「支付宝公钥」中填写用于验证支付宝返回信息的公钥内容。按当前接入要求,以单行密钥内容填写。
- 按应用已开通的产品选择「支付类型」:常规支付或当面付。
- 核对「是否启用沙盒模式」。测试时使用沙盒应用及其密钥,正式收款时关闭沙盒并换成正式参数。
当前接入使用 RSA2 公钥模式。「支付宝公钥」不是应用公钥,也不是证书文件路径。不要把证书模式教程中的参数直接填入这些字段。
账户能否使用某种支付产品,要以实际开通情况为准。后台提供该选项,不代表所有账户都能使用。
接入虎皮椒或易支付
选择「虎皮椒」后,在「虎皮椒配置」中填写支付网关、APPID 和 SECRET。网关默认是 https://api.xunhupay.com/payment/do.html;是否需要调整,以所用服务提供的资料为准。
选择「易支付」后,使用「易支付商户」中的共用商户资料。前台仍显示支付宝入口。不要将官方支付宝私钥填入第三方渠道的凭据字段。
选择前台支付形式
网页付款流程使用「跳转收银台」。只有接口实际返回二维码时,才适合选择「扫码」。选择「扫码」本身不会改变官方支付产品。
当前官方渠道会在手机和平板环境下使用 WAP 网页支付流程。因此,即使后台选择了当面付,也不要假定所有设备都会显示二维码;电脑和手机需要分别验证。
核对回跳与通知地址
官方渠道根据发起付款的前端地址自动生成以下入口:
/notify?gqPayment=alipay:付款后浏览器返回网站的地址。/api/callback?gqPayment=alipay:支付宝发送异步支付通知的地址。
这里的前端是买家访问的网站,不是 WordPress 后台。检查地址时不要替换成后台地址,也不要额外加上文章语言路径。上述地址说明针对官方渠道,第三方渠道应按各自接入方式核对。
保存并验证
- 保存设置,从目标前端打开有有效价格的购买项目,确认支付宝可选。
- 核对订单币种、渠道及测试或正式环境,发起付款。
- 分别检查电脑和手机上的收银台或二维码是否正常。
- 付款后核对订单支付状态,再检查对应内容或权益是否可用。
入口未显示时,先查渠道开关、支持币种和当前用户的购买条件。签名失败时,重点核对应用、环境及两种密钥是否填对。仅看到浏览器返回页面,不能证明订单已完成支付确认。