交易退款联动通知验签接口

返回文档首页

功能说明

此接口用于对HTTP联动通知数据签名进行验签.
您可以将接收到的HTTP联动通知数据填充到此调用接口.
支付服务会根据这些参数进行验签
您也可以调用ForcePaySDK的API进行验签

接口HOST地址

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

接口Action路径: /refundsignverify

请求方法: POST方法

请求参数

MerchantID 必填,字符串格式,大小写敏感.
商户的标识,标识了该交易订单的所属商家.
更多商户标识可以在控制台<获得产品支付入口>中查看.
TradeProduct 必填,最大长度500,字符串格式,大小写敏感.
产品的标识,标识了该交易订单的对应产品.
订单中包含多个产品标识进行合并付款,使用','号分割每个订单标识
TradeQuantity 必填,整数数字格式
指示了该交易订单购买产品的数量.
如果是多个产品合并付款,使用','号分割每个产品的数量
TradeNo 必填,字符串格式,大小写敏感.
订单的标识,这个标识是支付系统对此订单生成的唯一标识
RefundNo 必填,字符串格式.
此退款的标识,这个标识是支付系统对此退款生成的唯一标识
RefundAmount 必填,浮点格式,精确到2位小数
此退款操作的请求退款金额,以人民币为单位.
RefundReason 必填.字符串格式.
此退款操作的发起原因描述
RefundBeginTime 必填.日期时间格式.
此退款操作的开始时间
RefundEndinTime 必填.日期时间格式.
此退款操作的结束时间
RefundStatus 必填.字符串格式.
此退款操作的状态值.
RefundActual 必填,浮点格式,精确到2位小数
此退款操作的实际退款金额,以人民币为单位.
RefundCustomParam 选填.字符串格式.
此退款操作的自定义参数,在发起退款操作时进行设置.
RefundTimestamp 必填,字符串格式
此退款的通知时间戳
RefundSignMode 必填.字符串格式
此退款的签名模式
RefundSignature 必填.字符串格式
此退款的签名数据.该接口将对此数据进行验签
PrintVerifyStep 必填.字符串格式
指示了是否需要生成详细的验签步骤描述,生成描述会比较慢,
所以请在只需要结果,不需要验签步骤描述时设置为off,加快速度.
可选值为on,off

应答参数:

应答状态

如果验签的结果是正确可信的,返回HTTP状态码200和OK字符串
如果验签的结果是错误不可信,返回HTTP状态码400和FAILED字符串