代付接口文档

API协议接入规则

传输方式：HTTPS 请求方式：GET/POST 签名算法：md5 字符编码：UTF-8

API代付接口

请求API地址：

网关提交地址：https://（隐藏）/api.php 登录商户后台查看

请求参数说明：

字段名 变量名 是否必填 加入签名 示例值 描述
操作类型 act 是 是 daifu 此API固定值
商户ID pid 是 是 800800001 宝龙支付所创建的商户ID
代付方式 type 是 是 alipay alipay=支付宝代付，bank=银行卡代付（暂时只支持alipay）
代付订单号 out_trade_no 是 是 DF2023545621345656 该订单号需在商户网站内唯一
通知地址 notify_url 是 是 https://www.baidu.com/notify_url.php 代付成功后通知地址
代付金额 money 是 是 10.00 精确到小数点后两位，例如10.28
收款人姓名 name 是 是 张无忌 收款人姓名
帐号/卡号 account 是 是 aiqugame@163.com 收款人支付宝帐号/银行卡号
自定义参数 param 否 是 没有请留空 原封返回，避免特殊字符
md5签名 sign 是 否 468171c825c02408cc99935447c785a5 32位小写md5签名值，请参考底部签名算法
签名类型 sign_type 是 否 MD5 默认为MD5

返回结果：

字段名 变量名 示例值 描述
返回状态码 code 1 1为成功，其它值为失败
返回信息 msg 代付成功
商户ID pid 800800001
代付订单号 out_trade_no DF2023545621345656
代付金额 money 10.00
收款人姓名 name 张无忌
帐号/卡号 account aiqugame@163.com

代付结果通知：

字段名 变量名 加入签名 描述
商户ID pid 是 宝龙支付所创建的商户ID
平台订单号 trade_no 是 宝龙支付平台的订单号
商户订单号 out_trade_no 是 商户系统内部的订单号
支付状态 trade_status 是 只有TRADE_SUCCESS是代付成功
代付方式 type 是 alipay=支付宝代付，bank=银行卡代付（暂时只支持alipay）
业务扩展参数 param 是 原封返回，避免特殊字符
代付金额 money 是 提交订单金额，单位(元)
收款人姓名 name 是 收款人姓名
帐号/卡号 account 是 收款人支付宝帐号/银行卡号
md5签名 sign 否 验证订单是否为合法
签名类型 sign_type 否 默认为MD5
余额查询接口

请求API地址：

网关提交地址：https://（隐藏）/api.php 登录商户后台查看

请求参数说明：

字段名 变量名 是否必填 示例值 描述
操作类型 act 是 query 此API固定值
商户ID pid 是 800800001
商户密钥 key 是 468171c825c02408cc99935447c785a5

返回结果：

字段名 变量名 示例值 描述
返回状态码 code 1 1为成功，其它值为失败
返回信息 msg 查询成功
商户余额 money 10.00
代付订单查询接口

请求API地址：

网关提交地址：https://（隐藏）/api.php 登录商户后台查看

请求参数说明：

字段名 变量名 是否必填 示例值 描述
操作类型 act 是 dfquery 此API固定值
商户ID pid 是 800800001
商户密钥 key 是 468171c825c02408cc99935447c785a5
商户订单号 out_trade_no 是 DF46800809412171447

返回结果：

字段名 变量名 示例值 描述
返回状态码 code 1 1为成功，其它值为失败
返回信息 msg 代付成功
md5签名

1、将发送或接收到的所有参数按照参数名ASCII码从小到大排序（a-z），sign、sign_type、和空值不参与签名！
2、将排序后的参数拼接成URL键值对的格式，例如 a=b&c=d&e=f，参数值不要进行url编码。
3、再将拼接好的字符串与商户密钥KEY进行MD5加密得出sign签名参数，sign = md5 ( a=b&c=d&e=f + KEY ) （注意：+ 为各语言的拼接符，不是字符！），md5结果为小写。
4、具体签名与发起支付的示例代码可下载SDK查看。