开发文档

开发文档

网站首页 > 开发文档

  • 产品介绍
  • 创建支付订单
  • 继续支付
  • 查询订单
  • 申请退款
  • 付款成功回调
  • SDK代码示例
德恩信支付介绍
德恩信支付API 是 武汉德恩信科技有限公司 针对在线支付开发的支付接口。采用 HTTP POST 发送模式,德恩信支付API 提供完整且强大的支付便捷功能,个人企业均可使用,无须开通额外功能(H5支付、公从号等),即可让您的网站具备支付交易功能。在此强调:我们不接触客户资金,所有订单资金由微信、支付宝官方清算,保障资金安全。成功开通后,你们都是支付宝与微信的二级商户
智能收银台
根据不同支付场景自动实现微信与支付宝的支付功能。
支付宝支付接口
电脑支付、手机H5支付、扫码支付、商家分账、现金红包
微信支付接口
手机H5支付、扫码支付、微信JsApi公众号、商家分账、现金红包
网关请求URL
https://pay.deenxin.cn/kf/API/MSH/
http请求方式
post
数据传输与接收格式
jsonurlData,任选一种自己常用的方式,推荐使用json方式

json格式示例

{
"cmd":"add",
"toKen":"bU1GC8PVrLPLUpqkyaiq6Ie4FBQRPq3gykzitRNud1MIHI4lMo",
"ddh":"566592106453081",
"money":0.79,
"pay":33
}

urlData格式示例,记得对需要的参数进行编码:UrlEncode

https://pay.deenxin.cn/kf/API/MSH/?cmd=add&toKen={toKen}&ddh={ddh}&money={money}&pay=33
创建支付订单 介绍
创建新的支付订单,命令请求类型cmd:add
请求参数
参数名 必选 类型 说明
toKen string api秘钥 注册商户,开发配置中获取
cmd string add 命令请求类型:add|ing|check|tk
pay int
33 聚合支付(推荐)
3 支付宝PC
8 支付宝H5
30 支付宝扫码
13 微信扫码
18 微信jsapi公众号
19 微信H5
接口支付方式:33|3|8|30|13|18|19
ddh string 商户唯一订单号 示例:X20220901123290887
money decimal 订单金额 为单位,示例:108.66
ing boolean 是否执行继续付款 当订单号存在时,是否执行继续付款
title string 订单名称 可选项
ms string 商品描述 可选项
webCode string 网站标识代码 可选项
fz string 分账方案编号 不使用后台的默认分账方案,采取指定,可为字符串:false(不使用)
请求示例

json请求格式示例

{
"cmd":"add",
"toKen":"你的api秘钥,开发配置获取",
"ddh":"566592106453081",
"money":0.79,
"pay":33
}

urlData请求格式示例,记得对需要的参数进行编码:UrlEncode

https://pay.deenxin.cn/kf/API/MSH/?cmd=add&toKen={toKen}&ddh={ddh}&money={money}&pay=33
响应参数
参数名 必反 类型 说明
code int
200 操作成功
404 操作失败
202 订单已创建
303 未登录
状态码
message string 消息提示 反馈描述
data string 核心数据 状态码200必返
ddh string 订单号 商户订单号
state int
0 未付款
1 已付款
付款状态
cmd string 命令请求类型 命令请求类型
pay int 接口支付方式 接口支付方式
money decimal 订单金额 订单金额
响应示例

json响应格式示例

{
"code":200,
"message":"操作成功",
"state":0,
"data":"核心数据",
"cmd":"add",
"ddh":"196271864337455",
"money":0.3,
"pay":33
}

urlData响应格式示例,记得对需要的参数进行编码:UrlEncode

cmd=add&code={code}&data={data}&ddh={ddh}&message={message}&money={money}&pay={pay}&state={state}
继续支付 介绍
当订单创建后,未付款,可对该订单进行继续付款,命令请求类型cmd:ing
请求参数
参数名 必选 类型 说明
toKen string api秘钥 注册商户,开发配置中获取
cmd string ing 命令请求类型:add|ing|check|tk
ddh string 商户唯一订单号 订单号
pay int
33 聚合支付(推荐)
3 支付宝PC
8 支付宝H5
30 支付宝扫码
13 微信扫码
18 微信jsapi公众号
19 微信H5
接口支付方式:33|3|8|30|13|18|19,可变更支付方式
post boolean 是否执行付款成功回调 当该订单已付款时,是否执行付款成功回调操作
请求示例

json请求格式示例

{
"cmd":"ing",
"toKen":"你的api秘钥,开发配置获取",
"ddh":"566592106453081"
}

urlData请求格式示例,记得对需要的参数进行编码:UrlEncode

https://pay.deenxin.cn/kf/API/MSH/?cmd=ing&toKen={toKen}&ddh={ddh}
响应参数
参数名 必反 类型 说明
code int
200 操作成功
404 操作失败
303 未登录
状态码
message string 消息提示 反馈描述
data string 核心数据 状态码200必返
ddh string 订单号 商户订单号
state int
0 未付款
1 已付款
付款状态
cmd string 命令请求类型 命令请求类型
pay int 接口支付方式 接口支付方式
money decimal 订单金额 订单支付金额
响应示例

json响应格式示例

{
"code":200,
"message":"操作成功",
"state":0,
"data":"核心数据",
"cmd":"ing",
"ddh":"196271864337455",
"money":0.3,
"pay":33
}

urlData响应格式示例,记得对需要的参数进行编码:UrlEncode

cmd=ing&code={code}&data={data}&ddh={ddh}&message={message}&money={money}&pay={pay}&state={state}
查询订单 介绍
查询订单是否付款,在异步回调验证时,可请求此操作,命令请求类型cmd:check
请求参数
参数名 必选 类型 说明
toKen string api秘钥 注册商户,开发配置中获取
cmd string check 命令请求类型:add|ing|check|tk
ddh string 商户唯一订单号 订单号
post boolean 是否执行付款成功回调 当该订单已付款时,是否执行付款成功回调操作
请求示例

json请求格式示例

{
"cmd":"check",
"toKen":"你的api秘钥,开发配置获取",
"ddh":"566592106453081"
}

urlData请求格式示例,记得对需要的参数进行编码:UrlEncode

https://pay.deenxin.cn/kf/API/MSH/?cmd=check&toKen={toKen}&ddh={ddh}
响应参数
参数名 必反 类型 说明
code int
200 操作成功
404 操作失败
303 未登录
状态码
message string 消息提示 反馈描述
state int
0 未付款
1 已付款
付款状态,状态码200必返
toKen string api秘钥 已付款返回
payNum string 官方支付交易号 已付款返回
data string 同步跳转url 已付款返回
time string 付款时间 已付款返回
cmd string 命令请求类型 命令请求类型
ddh int 订单号 商户订单号
pay int 接口支付方式 接口支付方式
money decimal 订单金额 订单支付金额
响应示例

json响应格式示例

{
"toKen":"api秘钥",
"code":200,
"message":"操作成功",
"state":1,
"payNum":"官方交易号",
"time":"支付时间",
"data":"同步显示url",
"cmd":"check",
"ddh":"196271864337455",
"money":0.3,
"pay":33
}

urlData响应格式示例,记得对需要的参数进行编码:UrlEncode

cmd=check&toKen={toKen}&code={code}&ddh={ddh}&message={message}&money={money}&pay={pay}&state={state}&payNum={payNum}&time={time}&data={data}
付款成功回调 介绍
当订单支付成功后,系统会向商户后台《开发配置》中的异步网址发起异步请求,将支付参数传递过去。商户需要用《查询订单》接口来判断用户是否真实付款,然后在编写业务逻辑代码。
异步回调通知参数
参数名 必反 类型 说明
toKen string api秘钥 toKen
code int 状态码 200请求正确,404错误
state int 付款状态 付款状态:0未付款,1已付款
payNum string 官方支付交易号 官方交易号
time string 付款时间 支付时间
ddh int 订单号 支付订单号
pay int 接口支付方式 最终付款方式
money decimal 订单金额 支付金额
异步通知示例

json格式

{
"toKen":"api秘钥",
"code":200,
"state":1,
"payNum":"官方交易号",
"time":"支付时间",
"ddh":"196271864337455",
"money":0.3,
"pay":33
}

urlData格式

toKen={toKen}&code={code}&payNum={payNum}&time={time}&state={state}&ddh={ddh}&money={money}&pay={pay}
应答回应
商户可以根据 异步回调通知参数 编写业务逻辑代码,成功后页面输出字符串:200即可。
200
申请退款 介绍
对订单申请退款,支持多次退款请求,对于微信已结算分账的订单,佣金无法退回。命令请求类型cmd:tk
请求参数
参数名 必选 类型 说明
toKen string api秘钥 注册商户,开发配置中获取
cmd string tk 命令请求类型:add|ing|check|tk
ddh string 商户唯一订单号 订单号
money decimal 本次退款金额 为单位,当money为-1时,表示申请剩余全部金额
ly string 理由 退款理由,可为空
请求示例

json请求格式示例

{
"cmd":"tk",
"toKen":"你的api秘钥,开发配置获取",
"ddh":"566592106453081",
"money":-1
}

urlData请求格式示例,记得对需要的参数进行编码:UrlEncode

https://pay.deenxin.cn/kf/API/MSH/?cmd=tk&toKen={toKen}&ddh={ddh}&money={money}
响应参数
参数名 必反 类型 说明
code int
200 操作成功
404 操作失败
303 未登录
状态码
message string 消息提示 反馈描述
infoCode string 退款交易号 状态码200返回
响应示例

json响应格式示例

{
"cmd":"tk",
"code":200,
"message":"操作成功",
"infoCode":"067220928231436939409"
}

urlData响应格式示例,记得对需要的参数进行编码:UrlEncode

cmd=tk&code={code}&infoCode={infoCode}&message={message}