银联商务大华捷通综合支付网银支付接口文档

1.对于预授权交易,用户支付成功后,商户可以调用此接口做预授权完成处理
2.查询接口属于后台模式对接,商户后台技术人员可以发起http get/post请求,Content-Type设置为application/x-www-form-urlencoded,字符编码格式使用UTF-8
3.测试环境接口地址:https://dhjt-uat.chinaums.com/queryService/UmsWebPayPlugins
4.生产环境接口地址:https://生产域名/queryService/UmsWebPayPlugins
5.签名逻辑跟支付下单接口一样,如有不清楚的地方可以与大华捷通对接技术人员咨询
6.请求参数使用URLEncode进行URL编码后再进行传递,防止出现乱码问题
预授权完成接口请求参数
参数名称 参数说明 参数类型 长度 是否必须 备注
version 版本号 字符串 10 固定值:20191031
msgId 消息ID 字符串 4 固定值:10UU
msgType 消息类型 字符串 10 固定值:preAauthComplete
merOrderId 商户订单号 字符串 6..32 支付下单接口传入的支付订单号
requestTimestamp 报文请求时间 字符串 19 格式yyyy-MM-dd HH:mm:ss
mid 商户号 字符串 15
tid 终端号 字符串 8
billDate 订单下单日期 字符串 10 格式:yyyy-MM-dd(鼠标单击查看说明)
instMid 业务类型 字符串 1..32 固定值:UACDEFAULT
preAuthOrderId 原预授权交易订单号 字符串 32 原交易订单号
totalAmount 预授权完成金额 数字型 10
outAcctNo 银联网关交易结算账户号 字符串 64 Base64编码。 与下单接口中 原预授权交易 的结算账户号 相同。
acctType 银联网关交易 结算账户类型 字符串 2 银联网关退款交易时必传。
银行个人账 户:
1)个人银行 借记账户:01
2)个人银行 贷记账户:02
3)个人银行 准贷记账户: 03
4)银行预付 费账户:05
支付账户:
1)个人支付 账户:10
2)单位支付 账户:11
银行对公账 户:
1)对公银行 账户:20
termType 银联网关交易 终端类型 字符串 10 注意:银联网 关交易时需要 填写。
电脑:PC 手机:PHONE 其他:OTHERS
signType 签名算法 字符串 10 支持SM3(推荐),SHA256,不传默认SM3
sign 签名 字符串 64 签名规则(鼠标单击查看说明)
预授权完成接口响应参数
参数名称 参数说明 参数类型 长度 是否必须 备注
version 版本号 字符串 10 固定值:20191031
errCode 平台错误码 字符串 64 取值参考下面说明
errMsg 版本号 字符串 255/td>
merOrderId 商户订单号 字符串 6..32 支付下单接口传入的支付订单号
responseTimestamp 报文响应时间 字符串 19 格式yyyy-MM-dd HH:mm:ss
mid 商户号 字符串 15
tid 终端号 字符串 8
secureStatus 预授权交易状态 字符串 15
totalAmount 预授权完成金额 数字 15
sign 签名 字符串 64 签名规则(鼠标单击查看说明)
errCode取值说明
取值 描述 原因和应对措施 系统失败
SUCCESS 成功
INTERNAL_ERROR 内部错误 系统错误,请联系技术支持
BAD_REQUEST 请求报文有错 报文格式或字段值有误,请对照文档检查。
NO_SERVICE 没有能处理请求msgtype的服务 msgType错误,请检查文档,msgType是否拼写正确
POSITION_LACK 头寸不足 头寸不足
TIMEOUT 处理超时 处理超时,很可能是微信和支付宝的网络请求没应答,建议重试或者撤销交易
NO_ORDER 找不到请求的原始订单 对应的mid+merOrderId不正确,无法找到原交易,请检查merOrderId是否跟原交易一致。
OPERATION_NOT_ALLOWED 当前不允许此操作 订单已经关闭,不能执行退货等操作
TARGET_FAIL 支付宝方支付失败,如请求没有成功,或者请求成功,但是没有正确处理。 支付宝或者微信方业务失败,请根据返回信息确定具体原因。
DUP_ORDER 重复的订单请求 支付请求的merOrderId重复,请检查终端是否做过复位操作,导致流水号等重复。
NET_ERROR 跟支付包通讯出问题,包括请求发送异常,报文应答不是200,请求被取消,应答超时等。 通讯问题,联系运行检查网络情况。
NO_MERCHANT 找不到请求指定的商户 请求报文的mid在网付前置无法找到相关的配置,请确认终端的商户号是否正确在网付前置配置,是否经过转商户处理。
ORDER_PROCESSING 订单正在处理中,不允许并发操作。 当前订单的上一次操作没有完成,订单处于锁定状态,请等待一分钟后再试。
INACTIVE_MERCHANT 商户被置为inactive状态 交易商户在网付前置被冻结。
ABNORMAL_REQUEST_TIME 请求时间异常 请求终端或者平台的系统时间不正常,请检查系统时间。
TXN_DISCARDED 请求开始处理时间延迟过大,交易被丢弃。 系统负载过大,交易被丢弃,请联系运行。
BAD_SIGN 签名错误 报文签名错误,请联系技术指导签名算法。
INVALID_MSGSRC 商户来源错误 系统配置有问题,请联系技术。
INVALID_ORDER 订单信息异常 该订单支付时有异常,缺少关键数据,请先做一笔订单查询,补充关键数据后再次进行退货等操作。
NO_CROSS_DAY_TRADING 不允许跨日交易 可能某些渠道不支持跨日撤销,建议做退货。
DENIED_IP 不允许此IP交易 IP不在白名单中,请联系管理员确认。
INVLID_MERCHANT_CONFIG 错误的商户配置 商户配置参数有问题,请联系业务人员检查商户配置参数。
INVALID_RESPONSE 无效的应答报文 支付渠道方的应答报文有问题,比如验签失败、报文格式错误等。
targetSys取值说明
取值 描述
Alipay 1.0 支付宝1.0协议
Alipay 2.0 支付宝2.0协议
WXPay 微信
YQB 壹钱包
QMF 全民付远程快捷
UnionPay 银联钱包
BaiDu 百度钱包
JD 京东钱包
SF 顺丰顺手付
refundStatus取值说明
取值 描述
UNKNOWN 不明确的交易状态,需要调退款查询接口确认退款结果
SUCCESS 退款成功
FAIL 退款失败
PROCESSING 退款处理中,需要调退款查询接口确认退款结果
status取值说明
取值 描述
NEW_ORDER 新订单
UNKNOWN 不明确的交易状态
TRADE_CLOSED 关闭的交易,不允许进行任何操作
WAIT_BUYER_PAY 交易创建,等待买家付款
TRADE_SUCCESS 支付成功
TRADE_REFUND 订单转入退货流程,可能是部分也可能是全部