支付接口介绍

使用此接口可以实现支付宝、QQ钱包、微信支付与财付通的即时到账，免签约，无需企业认证。接口API地址是：https://pay.tgyzf.com/

本文阅读对象：商户系统(在线购物平台、人工收银系统、自动化智能收银系统或其他)集成糖果易支付涉及的技术架构师，研发工程师，测试工程师，系统运维工程师。

接口申请方式

共有两种接口模式：

(一)普通支付商户

可以获得一个支付商户。请进行注册申请，申请之后会将商户ID和商户KEY给你！

协议规则

传输方式：HTTP

数据格式：JSON

签名算法：MD5

字符编码：UTF-8

[API]查询商户信息与结算规则

URL地址：https://pay.tgyzf.com/api.php?act=query&pid={商户ID}&sign={签名字符串}

请求参数说明：

字段名变量名必填类型示例值描述

操作类型act是Stringquery此API固定值

商户IDpid是Int1001

签名字符串sign是String67d12af9ddbe38d9c7b0931ad102ca3c签名算法与支付宝签名算法相同

返回结果：

字段名变量名类型示例值描述

返回状态码codeInt11为成功，其它值为失败

商户IDpidInt1001所创建的商户ID

商户密钥keyString(32)89unJUB8HZ54Hj7x4nUj56HN4nUzUJ8i所创建的商户密钥

商户类型typeInt1此值暂无用

商户状态activeInt11为正常，0为封禁

商户余额moneyString0.00商户所拥有的余额

结算账号accountString1070077170@qq.com结算的支付宝账号

结算姓名usernameString张三结算的支付宝姓名

满多少自动结算settle_moneyString30此值为系统预定义

手动结算手续费settle_feeString1此值为系统预定义

每笔订单分成比例money_rateString98此值为系统预定义

[API]查询结算记录

URL地址：https://pay.tgyzf.com/api.php?act=settle&pid={商户ID}&sign={签名字符串}

请求参数说明：

字段名变量名必填类型示例值描述

操作类型act是Stringsettle此API固定值

商户IDpid是Int1001

签名字符串sign是String67d12af9ddbe38d9c7b0931ad102ca3c签名算法与支付宝签名算法相同

返回结果：

字段名变量名类型示例值描述

返回状态码codeInt11为成功，其它值为失败

返回信息msgString查询结算记录成功！

结算记录dataArray结算记录列表

[API]查询单个订单

URL地址：https://pay.tgyzf.com/api.php?act=order&pid={商户ID}&out_trade_no={商户订单号}&sign={签名字符串}

请求参数说明：

字段名变量名必填类型示例值描述

操作类型act是Stringorder此API固定值

商户IDpid是Int1001

商户订单号out_trade_no是String20160806151343349

签名字符串sign是String67d12af9ddbe38d9c7b0931ad102ca3c签名算法与支付宝签名算法相同

返回结果：

字段名变量名类型示例值描述

返回状态码codeInt11为成功，其它值为失败

返回信息msgString查询订单号成功！

易支付订单号trade_noString2016080622555342651糖果易支付订单号

商户订单号out_trade_noString20160806151343349商户系统内部的订单号

支付方式typeStringalipayalipay:支付宝,tenpay:财付通,

qqpay:QQ钱包,wxpay:微信支付

商户IDpidInt1001发起支付的商户ID

创建订单时间addtimeString2016-08-06 22:55:52

完成交易时间endtimeString2016-08-06 22:55:52

商品名称nameStringVIP会员

商品金额moneyString1.00

支付状态statusInt01为支付成功，0为未支付

[API]批量查询订单

URL地址：https://pay.tgyzf.com/api.php?act=orders&pid={商户ID}&sign={签名字符串}

请求参数说明：

字段名变量名必填类型示例值描述

操作类型act是Stringorders此API固定值

商户IDpid是Int1001

查询订单数量limit否Int20返回的订单数量，最大50

签名字符串sign是String67d12af9ddbe38d9c7b0931ad102ca3c签名算法与支付宝签名算法相同

返回结果：

字段名变量名类型示例值描述

返回状态码codeInt11为成功，其它值为失败

返回信息msgString查询结算记录成功！

订单列表dataArray订单列表

[API]支付订单退款

URL地址：https://pay.tgyzf.com/api.php?act=refund&pid={商户ID}&out_trade_no={商户订单号}&sign={签名字符串}

只支持微信官方、QQ钱包官方、当面付退款

请求参数说明：

字段名变量名必填类型示例值描述

操作类型act是Stringrefund此API固定值

商户IDpid是Int1001

商户订单号out_trade_no是Int1000

退款原因desc否String

退款金额money否Double20.00不填默认退全款

签名字符串sign是String67d12af9ddbe38d9c7b0931ad102ca3c签名算法与支付宝签名算法相同

返回结果：

字段名变量名类型示例值描述

返回状态码codeInt11为成功，其它值为失败

返回信息msgString退款成功!

发起支付请求

URL地址：https://pay.tgyzf.com/submit.php?pid={商户ID}&type={支付方式}&out_trade_no={商户订单号}&notify_url={服务器异步通知地址}&return_url={页面跳转通知地址}&name={商品名称}&money={金额}&sitename={网站名称}&sign={签名字符串}&sign_type=MD5

请求参数说明：

字段名变量名必填类型示例值描述

商户IDpid是Int1001

支付方式type是Stringalipayalipay:支付宝,tenpay:财付通,

qqpay:QQ钱包,wxpay:微信支付

商户订单号out_trade_no是String20160806151343349

异步通知地址notify_url是Stringhttp://域名/notify_url.php服务器异步通知地址

跳转通知地址return_url是Stringhttp://域名/return_url.php页面跳转通知地址

商品名称name是StringVIP会员

商品金额money是String1.00

网站名称sitename否String某某某平台

签名字符串sign是String202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同

签名类型sign_type是StringMD5默认为MD5

支付结果通知

通知类型：服务器异步通知(notify_url)、页面跳转通知(return_url)

请求方式：GET

特别说明：回调成功之后请输出 SUCCESS字符串，如果没有收到商户响应的SUCCESS字符串，系统将通过策略重新通知5次，通知频率为15s/60s/3m/30m/1h

请求参数说明：

字段名变量名必填类型示例值描述

商户IDpid是Int1001

易支付订单号trade_no是String20160806151343349021糖果易支付订单号

商户订单号out_trade_no是String20160806151343349商户系统内部的订单号

支付方式type是Stringalipayalipay:支付宝,tenpay:财付通,

qqpay:QQ钱包,wxpay:微信支付

商品名称name是StringVIP会员

商品金额money是String1.00

支付状态trade_status是StringTRADE_SUCCESS

签名字符串sign是String202cb962ac59075b964b07152d234b70签名算法与支付宝签名算法相同

签名类型sign_type是StringMD5默认为MD5

签名算法

请对参数按照键名进行降序排序(a-z)sign sign_type 和空值不进行签名！。

排序后请操作参数生成或拼接一个url请求字符串 例如 a=b&c=d&e=f (Url值不能携带参数！不要进行urlencode)

再将拼接好的请求字符串与平台生成的Key进行MD5加密得出sign签名参数 MD5 ( a=b&c=d&e=f + KEY ) (注意：+ 为各语言的拼接符！不是字符！)