接入提示
不提供BC、SSC、JR、QP、CP等涉及黄赌毒行业的支付接入,其他行业接入需审核通过方可开通接口
接入要求:
1.正规行业站点
2.接入站点域名需ICP网站备案
创建订单
请求方式:GET / POST
请求网址:http://pay.dongluhitec.net/api/submit
参数说明:
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 默认 1.0
项目编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(32)
订单金额 totalfee decimal(10,2) 最多两位小数
订单标题 subject varchar(128)
订单描述 body varchar(128)
异步通知URL notifyurl varchar(50) 不能带有任何参数
同步跳转URL returnurl varchar(50) 不能带有任何参数
md5签名 sign varchar(32) 参照md5签名方法
分区判断 server varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
备注说明 remark varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
返回参数说明:
参数名称 变量名 类型长度 是否必须 说明
状态码 code int 0成功其他失败
消息 msg varchar(255)
数据 data JSON 下单成功返回
data说明
商户订单号 sdorderno varchar(32)
支付地址 url varchar
md5签名方法:
version={value}&customerid={value}&totalfee={value}&sdorderno={value}&notifyurl={value}&returnurl={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
异步通知回调
通知方式:POST
收到通知回复:success
回调失败的处理:如果收到商户的回复不符合规范或超时,会判定本次通知失败,重新发送通知,直到成功为止,但不保证通知最终一定能成功
参数说明:
参数名称 变量名 类型长度 说明
项目编号 customerid int(6)
商户订单号 sdorderno varchar(20)
平台订单号 sdpayno varchar(20)
交易金额 totalfee decimal(10,2) 通知回调业务处理过程中务必验证交易金额,支付失败返回交易金额为0
支付类型 paytype varchar(12) alipay -> 支付宝
weixin -> 微信扫码
md5验证签名 sign varchar(32) 参照md5签名方法
分区判断 server varchar(50) 原样返回
备注说明 remark varchar(50) 原样返回
md5签名方法:
customerid={value}&totalfee={value}&sdorderno={value}&sdpayno={value}&paytype={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
同步通知跳转
通知方式:GET
其他说明:请不要在同步通知页面处理交易结果,最终结果以异步通知为准
参数说明:同异步参数说明
md5签名方法:同异步md5签名方法
付款码支付
请求方式:GET / POST
请求网址:http://pay.dongluhitec.net/api/micropay
参数说明:
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 默认 1.0
项目编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(32)
付款码 authCode varchar(32)
订单金额 totalfee decimal(10,2) 最多两位小数
订单标题 subject varchar(128)
订单描述 body varchar(128)
md5签名 sign varchar(32) 参照md5签名方法
分区判断 server varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
备注说明 remark varchar(50) 支付通知中原样返回,该字段主要用于商户携带订单的自定义数据
返回参数说明:
参数名称 变量名 类型长度 是否必须 说明
状态码 code int 0 成功
2005 需要支付用户确认,请稍后调用查询订单接口查询状态。
其他 失败,请用新订单号重新下单。
消息 msg varchar(255)
数据 data JSON 状态码0时返回
data说明
商户订单号 sdorderno varchar(32)
支付类型 paytype varchar alipay -> 支付宝
weixin -> 微信扫码
订单时间 datetime varchar(14) yyyyMMddHHmmss
md5签名方法:
version={value}&customerid={value}&authCode={value}&totalfee={value}&sdorderno={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
订单查询
请求方式:GET / POST
请求网址:http://pay.dongluhitec.net/api/query
参数说明:
参数名称 变量名 类型长度 是否必须 说明
版本号 version varchar(5) 默认 1.0
项目编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(20)
md5签名 sign varchar(32) 参照md5签名方法
md5签名方法:
version={value}&customerid={value}&sdorderno={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
结果返回:
参数名称 变量名 类型长度 说明
支付状态 status int(2) 0 -> 已付款
1 -> 未付款
2 -> 支付中
3 -> 支付失败
4 -> 已关闭订单
商户订单号 sdorderno varchar(20)
平台订单号 sdpayno varchar(20)
交易金额 totalfee decimal(10,2) 最多两位小数
支付类型 paytype varchar(12) alipay -> 支付宝
weixin -> 微信扫码
订单时间 datetime varchar(14) yyyyMMddHHmmss
订单关闭
请求方式:GET / POST
请求网址:http://pay.dongluhitec.net/api/close
参数说明:同订单查询参数说明
md5签名方法:同订单查询md5签名方法
结果返回:success
其他说明:订单成功关闭会返回success
订单退款
请求方式:GET / POST
请求网址:http://pay.dongluhitec.net/api/refund
结果返回:success
其他说明:订单成功退款会返回success
其他说明:调用本接口后,已付款金额将原路退回支付方,但商户在本平台已产生的平台手续费不退还,请确保商户账户余额大于已付款金额
参数说明:
参数名称 变量名 类型长度 是否必须 说明
商户退款单号 sdrefundno varchar(20) 退款业务单号,一般为商户订单号前加R,可全额退款,也可多次部分退款
例:
商户订单号001
全额退款:商户退款单号R001
部分退款:商户退款单号R001-1,R001-2,R001-3(以此类推,不能重复)
退款金额 refundfee decimal(10,2) 最多两位小数且金额不能大于商户订单可退金额
可退金额 = 实付金额 - 已退款金额
版本号 version varchar(5) 默认 1.0
项目编号 customerid int(6) 商户后台获取
商户订单号 sdorderno varchar(20)
md5签名 sign varchar(32) 参照md5签名方法
md5签名方法:
version={value}&customerid={value}&sdorderno={value}&sdrefundno={value}&refundfee={value}&apikey={value}
使用md5签名上面拼接的字符串即可生成小写的32位密文
集成测试
使用账号test密码test登陆平台获取接入秘钥(APIKey)进行商户系统集成开发
使用创建订单接口生成付款订单后,无需实际付款,使用测试商户进入商户后台->交易订单,在对应订单点击付款进行订单模拟支付后,再点击通知图标对商户系统进行异步回调

接入注意事项:
1.付款结果以异步通知为准
2.不论异步通知还是同步通知必须再次验证totalfee金额是否与发起支付时的金额一致,支付失败返回交易金额为0
3.我方支付系统有可能进行多次异步回调,要做好商户系统接收通知接口的订单处理逻辑,避免订单重复处理
4.订单支付成功后会对商户系统进行异步回调,商户系统需在订单处理完成后输出"success"反馈订单处理结果,否则我方支付系统会根据策略,间隔时间持续多次进行异步回调直至接收到"success"停止