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