功能说明

对已经完成的交易订单进行确认,确认完成后此订单的交易资金才会结算到商家.

 

 

接口HOST地址

取决于您原力支付服务部署所在的主机网络地址.
请注意确保防火墙设置已经允许通过该网络地址端口进行访问.
如果要修改此接口地址请通过<原力支付控制台>-<系统设置>进行设置

接口Action路径: /tradeconfirm

请求方法: GET方法

请求参数

MerchantID	必填,最大长度12,字符串格式,大小写敏感. 商户的标识,标识了该交易订单的所属商家. 更多商户标识可以在控制台<获得产品支付入口>中查看.
TradeNo	必填,最大长度18,字符串格式,大小写敏感 要进行确认的交易唯一标识,此唯一标识是通过交易成功回调返回的,也可以在控制台查找到
TradeToken	必填,最大长度32,字符串格式. 要进行确认的交易的凭据,此凭据是通过交易成功回调返回的,也可以再控制台查找到 此凭据即支付宝微信的交易流水单号
ConfirmStatus	必填,最大长度18,字符串格式,大小写敏感 交易确认的状态,可选状态值为:FinishConfirm 例如:ConfirmStatus=FinishConfirm
ConfirmDesc	必填,最大长度50,字符串格式 交易确认时的描述备注信息
ConfirmTimestamp	必填,最大长度18,字符串格式,大小写敏感 交易确认请求的时间戳,应通过当前时间进行生成,格式为YYYYMMDDHHMMSS 例如:20190429161256,支付系统会验证这个时间戳误差不能超出10分钟
ConfirmSignMode	必填,字符串格式 此交易确认请求的签名模式,支持的签名模式有如下: MD5 --使用MD5进行简单签名 RSA_SHA256 --使用基于RSA非对称加密的SHA256签名算法,非常安全
ConfirmSignature	必填,字符串格式 此交易确认请求的数据安全签名,请根据安全签名格式说明进行计算设置

应答参数

以下是请求成功返回的参数:
MerchantID--返回了确认操作对应的商户标识
TradeNo --返回了确认对应的交易唯一标识
Result --指示了此次操作结果是否成功
ResultDesc--指示了此次操作结果详细说明

应答状态

成功返回200,失败返回对应错误码与错误描述

备注

为了保证资金安全,请求交易确认API接口需要对请求数据进行安全签名,安全签名可分为MD5,RSA_SHA256两种方式.
安全签名实现方法请参阅<安全签名算法说明>.您也可以直接使用ForcePaySDK来生成安全签名.

原力支付系统控制台可以开启或关闭交易确认API接口,可以指定该接口的验签算法以及限制调用的来源IP地址.
在使用RSA_SHA256进行安全签名时,会用到商户私钥数据,此私钥数据需要先从控制台进行导出.