library_books 思博业务

易支付插件使用教程

概述

易支付插件用于对接第三方易支付平台,支持支付宝、微信、QQ钱包等多种支付方式。插件同时支持页面跳转支付和API接口支付两种调用方式,适用于PC端和移动端场景。

易支付官方文档:根据您使用的易支付平台查看对应文档

功能特性

  1. 多支付方式:支持支付宝、微信支付、QQ钱包
  2. 双模式支付:页面跳转支付(用户跳转到支付页面)和 API 接口支付(返回二维码)
  3. 异步回调验签:自动验证支付结果签名
  4. 同步跳转处理:用户支付完成后自动跳转回业务页面

后台配置

进入后台,依次点击 系统设置 → 支付设置 → 支付通道 → 添加通道,选择「易支付插件」。

配置参数

配置项说明
易支付链接易支付平台的网关地址,如 https://pay.example.com/
id商户ID,在易支付平台获取
密钥商户密钥,在易支付平台获取
支付方式选择默认的支付方式:支付宝 / 微信 / QQ钱包
调用方式页面跳转支付(用户跳转到易支付页面)或 API接口支付(返回二维码)

调用方式说明

方式说明适用场景
页面跳转支付用户点击后跳转到易支付页面,选择支付方式完成支付PC端,用户可见完整的支付页面
API接口支付系统调用易支付 API 获取支付二维码/链接,直接返回给用户移动端、嵌入式场景

前台使用流程

  1. 用户提交订单,进入支付选择页面
  2. 选择「易支付」作为支付方式
  3. 根据后台配置,系统跳转到易支付页面 或 展示支付二维码
  4. 用户完成支付
  5. 支付成功后自动跳转回业务页面

常见问题

Q:提示「易支付插件配置缺失」?
A:请检查后台支付通道配置中是否已完整填写「易支付链接」、「id」、「密钥」和「支付方式」四个参数。

Q:页面跳转后显示 404?
A:请确认「易支付链接」配置正确,以 https:// 开头,且易支付平台可以正常访问。

Q:API 接口支付返回「网络请求失败」?
A:请检查服务器能否正常访问易支付平台的 API 接口,可能需要放行服务器防火墙。

Q:支付成功但订单状态未更新?
A:请检查 notify_url 回调地址是否可被外网访问。异步回调需要公网可达,内网环境需配置隧道或端口映射。

Q:签名错误怎么办?
A:请确认密钥与易支付平台的一致,且配置中未包含多余的空格。

chat_bubble_outline 2 条评论 2

edit 发表评论

目录