个人支付宝微信收款插件开发文档(V2.0版本)

Karson 8天前 397

免责声明

此文档为个人微信支付免签收款插件V2.0的API接口文档,你可以按照此文档将个人二维码收款系统对接到你的商城或订单系统中,不局限于PHP,任何语言、任何客户端都可以接入。

V1.0版本请参考https://forum.fastadmin.net/thread/2043

发起支付请求


接口功能

发起支付请求或获取支付二维码相关信息

URL

http://www.yoursite.com/addons/pay/api/create

参数格式

form-data

HTTP请求方式

GET|POST

请求参数

参数必选类型说明
pricestring支付的金额
out_order_idstring你订单系统的唯一订单号
typestring请求支付的方式,wechat:微信 alipay:支付宝
signstring签名,构造格式见下方的签名方法
notifyurlstring支付成功的回调通知URL,为空将以插件管理中配置的URL为准
returnurlstring支付成功后跳转的URL,为空将以插件管理中配置的URL为准
extendstring自定义信息,此信息将在notifyurl中原封不动的回传,通常用于传递会员ID、会员名称等信息
formatstring请求输出的格式,默认为html,可选json或xml的方式,为html时页面将输出HTML内容

签名方法

md5(md5(price+out_order_id+type+notifyurl+returnurl+extend)+secretkey)

返回格式

JSON|XML|HTML

返回字段

返回字段字段类型说明
codeint返回结果状态。0:失败;1:成功。
msgstring提示文字信息
dataobject订单数据,JSON格式

返回订单数据字段列表

字段名字段类型说明
out_order_idstring外部订单号
pricefloat订单金额
discountpricefloat优惠金额
realpricefloat实际需要支付的金额
typestring支付类型
order_idint个人收款插件内部订单号
remainsecondsint二维码剩余有效时长(秒)
extendstring自定义传递的信息
statusstring订单状态:inprogress=进行中
returnurlstring成功后跳转的URL链接地址(带参数)
payurlstring网页支付的链接URL地址(非二维码地址)
queryurlstring查询订单状态的URL地址(带参数)
qrcodeurlstring二维码URL(可用于生成二维码进行支付使用)

发起查询请求


接口功能

发起查询请求,用于查询订单支付状态

URL

http://www.yoursite.com/addons/pay/api/query

参数格式

form-data

HTTP请求方式

GET|POST

请求参数

参数必选类型说明
out_order_idstring你订单系统的唯一订单号
signstring签名,构造格式见下方的签名方法
formatstring请求输出的格式,默认为html,可选json或xml的方式,为html时页面将输出HTML内容

签名方法

md5(md5(out_order_id)+secretkey)

返回格式

JSON|XML|HTML

返回字段

返回字段字段类型说明
codeint返回结果状态。0:失败;1:成功。
msgstring提示文字信息
dataobject订单数据,JSON格式,内容同创建订单数据格式相同

订单状态

字段名字段类型说明
inprogressstring进行中
expiredstring已过期
paidfloat已支付
settledstring交易完成
unsettledstring回调通知失败

取消订单请求


接口功能

取消订单,用于取消生成的订单,释放占用的二维码

URL

http://www.yoursite.com/addons/pay/api/cancel

参数格式

form-data

HTTP请求方式

GET|POST

请求参数

参数必选类型说明
order_idstring通过创建订单接口生成的订单号order_id
signstring签名,构造格式见下方的签名方法
formatstring请求输出的格式,默认为html,可选json或xml的方式,为html时页面将输出HTML内容

签名方法

md5(md5(order_id)+secretkey)

返回格式

JSON|XML|HTML

返回字段

返回字段字段类型说明
codeint返回结果状态。0:失败;1:成功。
msgstring提示文字信息

回调通知请求


接口功能

用户支付成功后会主动发送通知请求notify_url到你的服务器

HTTP请求方式

POST

请求参数

返回字段字段类型说明
order_idstring免签支付系统中的订单流水号
out_order_idstring你订单系统的唯一订单号
pricefloat订单金额
realpricefloat实际支付金额
typestring支付的方式,wechat:微信 alipay:支付宝
paytimeint支付时间,时间戳
extendstring原样返回你请求的extend信息
signstring签名,构造格式见下方的签名方法

签名方法

md5(md5(order_id + out_order_id + price + realprice + type + paytime + extend)+secretkey)

返回信息

接收到通知后必须返回success这个英文单词,不可以再返回其它任何信息

支付成功跳转


接口功能

用户支付成功后会跳转到对应的return_url链接,请勿在此接口处理订单逻辑,订单逻辑应该在上方的回调通知请求中处理

HTTP请求方式

GET

请求参数

返回字段字段类型说明
order_idstring免签支付系统中的订单流水号
out_order_idstring你订单系统的唯一订单号
signstring签名,构造格式见下方的签名方法

签名方法

md5(md5(order_id + out_order_id)+secretkey)

返回信息

无需返回信息,请自定义展示页面给用户查看

最后于 8天前 被Karson编辑
最新回复 (11)
  • NotTorrow 5天前
    感谢TA
    0 引用 2

    没有更新公告么?

  • Karson 楼主 打赏 5天前
    感谢TA
    0 引用 3

    @NotTorrow 目前官网只提供2.0下载,不再提供1.0包下载,感谢你的支持。

  • mariotao 5天前
    感谢TA
    0 引用 4

    老板, apk 的密钥在哪里可以找到呢?

  • shunlige 5天前
    感谢TA
    0 引用 5

    2.0 比 之前版本更新了什么?

  • Karson 楼主 打赏 5天前
    感谢TA
    0 引用 6

    @mariotao 后台插件管理,配置中可以找到

  • Karson 楼主 打赏 5天前
    感谢TA
    0 引用 7

    @shunlige 新增多设备轮询,同时操作更简单。

  • sqigood 4天前
    感谢TA
    0 引用 8

    授权要多久啊?老板,能不能泛域名?还是要具体的域名

  • xqk1234 4天前
    感谢TA
    0 引用 9

    升级后之前上传的收款二维码还在吗

  • 阿拉B 3天前
    感谢TA
    0 引用 10

    什么时候审核通过啊域名

  • likeni 1天前
    感谢TA
    0 引用 11

    一升级就尴尬,能不能每次升级只覆盖新增部分啊!!!。一个支付,一个cms,升级后都初始化了!!!!!!!
    升级支付后,提示错误。我查了是不是设置中图片来自本地还是远程这个要选。可是2.0版本没有这个!!TIM截图20181214020208.png

  • likeni 1天前
    感谢TA
    0 引用 12

    TIM截图20181214020450.png

  • 未登录
    13
返回