即时到账批量退款无密接口(refund_fastpay_by_platform_nopwd)

订单导出及订单信息更新功能说明2012年3月1. 背景●对于广大代理商的业务需求,TTS后台业务逻辑现阶段还不能做到与所有OTA的业务逻辑一致.各代理人可能针对于自己的产品有不同的处理逻辑.此需求为了尽量适应所有代理的业务需求,提供更加开放且灵活的订单系统.2. 接口描述2.1. 接口概述一年前开发的订单导出功能现阶段已不能再满足部分大代理人的需求，所以需要更新，增加部分功能。

●新品接口升级后增加以下功能1.订单导出功能增加部门需要导出的字段2.票号回传接口需要增加部分功能。

2.2. 订单导出订单导出功能现有，全量导出，增量导出，精确导出，按状态导出(现名称叫”支付成订单导出”)。

导出的XML格式需要保持一致。

2.2.1. 订单导出新加字段说明现有XML结构；现有的字段：result节点∙status接口返回相应的状态,ok是成功,error是失败msg节点(当result.status=error时,返回msg节点) ∙content接口返回的错误信息order节点∙id唯一标识ID∙orderNo订单号∙allPrice订单金额∙status订单状态∙contact联系人姓名∙contactMob联系人电话∙contactEmail联系人邮箱∙payStatus支付方式∙createTime订单创建时间∙needPS是否需要配送∙kdAddress快递地址∙kdPrice 快递费用∙kdmethod快递方式∙kdPhone收件人电话∙kdReceiver收件人∙source订单来源∙payTransactionid支付交易流水号∙pnrHasPinyin旅客姓名是否有拼音∙refundTransactionid退款交易流水号∙policyCode政策编号∙policyId政策id∙deadlineDate 标注最晚出票时间，格式为yyyy-mm-dd hh:mm:ss flight节点∙code航班号∙cabin舱位∙dep出发机场∙arr到达机场∙depDay出发日期∙depTime出发时间∙arrTime到达时间∙pnr PNR∙cpnr儿童PNR∙realCode真实航班号,若不为空则是共享航班∙viewPrice票面价∙price价格∙constructionFee机场建设费∙fuelTax燃油附加费∙childFuelTax儿童燃油附加费∙policyType订单类型∙id 航段id∙tgq 退改签∙cabinDesc 仓位说明∙yPrice Y仓价格passenger节点∙name乘机人姓名∙id乘机人id∙ageType乘机人类型0为成人,1为儿童∙cardType乘机人证件类型∙NI=身份证∙PP=护照∙ID=其他∙HX=回乡证∙TB=台胞证∙GA=港澳通行证∙HY=国际海员证∙cardNum乘机人证件号∙eticketNum票号∙insuranceCount保险数量∙insuranceNo 保险单号∙ticketTime 出票时间∙birthday 出生日期∙gender 性别log节点∙operator操作人∙time操作时间∙action行为2.3. 订单导出功能逻辑更改现在存在的订单导出方式：1.全量导出2.增量导出3.按状态导出4.精确导出全量导出：现有全量导出的逻辑为，一次性导出一年内的订单。

中国工商银行银企互联系统接口说明V e r s i o n42中国工商银行银企互联系统接口说明Version 4.2中国工商银行电子银行部中国工商银行北京软件研发部2005年07月目录1帐户查询 (1)1.1单帐户余额查询 (1)提交包 (1)返回包 (1)1.2多帐户余额查询 (2)提交包 (2)返回包 (3)1.3当日明细查询 (4)提交包 (4)返回包 (5)1.4历史明细查询 (6)提交包 (6)返回包 (7)1.5现金管理户当日明细查询 (8)提交包 (9)返回包 (9)1.6现金管理户历史明细查询 (11)提交包 (11)返回包 (11)2转帐支付（逐笔） (13)支付提交包 (13)支付返回包 (15)逐笔支付查询提交包 (15)逐笔支付查询返回包 (16)3企业财务室 (17)3.1财务室批量指令 (17)提交包 (17)返回包 (19)3.2财务室批量指令查询 (19)提交包 (19)返回包 (20)4收费站 (22)4.1批量扣个人指令 (22)提交包 (22)返回包 (23)4.2批量扣个人指令查询 (24)提交包 (24)返回包 (24)4.3缴费个人信息查询 (25)提交包 (26)4.4批量扣企业指令 (27)提交包 (27)返回包 (29)4.5批量扣企业指令查询 (29)提交包 (29)返回包 (30)4.6缴费企业信息查询（只查已签订协议的） (31)提交包 (31)返回包 (32)5批量代理汇兑 (33)5.1代理汇兑指令提交 (33)提交包 (33)返回包 (35)5.2代理汇兑指令查询 (35)提交包 (35)返回包 (36)5.3网点信息下载 (37)提交包 (38)返回包 (38)6批量外汇汇款 (39)6.1集团内外汇资金调拨指令提交 (39)提交包 (39)返回包 (40)6.2集团内外汇资金调拨指令查询 (41)提交包 (41)返回包 (41)6.3B股资金清算指令提交 (43)提交包 (43)返回包 (44)6.4B股资金清算指令查询 (45)提交包 (45)返回包 (45)6.5国内外汇汇款指令提交 (47)提交包 (47)返回包 (48)6.6国内外汇汇款指令查询 (49)提交包 (49)返回包 (49)7电子商务 (51)7.1B2C订购指令查询 (51)提交包 (51)返回包 (52)7.2B2C退货、返还、转付指令查询 (53)返回包 (54)7.3B2B订购指令查询 (56)提交包 (56)返回包 (57)7.4B2B退货、返还指令查询 (59)提交包 (59)返回包 (60)7.5C2C订购指令查询 (61)提交包 (61)返回包 (62)7.6B2B/B2C退货、返还、转付指令提交 (64)提交包 (64)返回包 (65)7.7个人联名卡签权指令 (66)提交包 (66)返回包 (67)8工资单 (67)8.1工资单文件上传 (67)提交包 (67)返回包 (69)8.2工资单文件查询 (70)提交包 (70)返回包 (70)8.3工资单文件删除 (71)提交包 (72)返回包 (72)9附录错误代码 (73)9.1明文返回的错误代码 (73)9.2xml中retCode的错误代码 (73)1帐户查询1.1 单帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceOp</opName><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur>例：RMB<retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>1.2 多帐户余额查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceListOp</opName><ReqParam><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><ReqReserved3>请求包备用字段3</ReqReserved3><ReqReserved4>请求包备用字段4</ReqReserved4></ReqParam></ReqParamSet></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceListOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property>中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet><ErrSet><Err><Account_num>账号</Account_num><errMessage>出错信息</errMessage></Err></ErrSet></opRep></ICBCYH>1.3 当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_date>交易日期</Trans_date>（例：yyyy-MM-dd-HH:mm:ss:6位毫秒）共26位<Check_num>凭证号</Check_num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.4 历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项（例：yyyyMMdd）<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项（以分为单位，不带小数点）<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Trans_date>交易日期</Trans_date> （例：yyyyMMdd）<Check_num>凭证号</Check_num><Trans_abstr>摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Rec_Account_num>对方账号</Rec_Account_num><Bank_name>开户行名称</Bank_name><Bank1_name>对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type>业务种类</Trans_type> 中文<Yt>用途</Yt><Trans_time>交易时间</Trans_time>（例：yyyy-MM-dd-HH:mm:ss:6位毫秒）共26位其值与当日明细中“交易日期”字段值一致<sign>借贷标志</sign> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5 现金管理户当日明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_time>交易时间</Trans_time> HH:mm:ss<Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.6 现金管理户历史明细查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项（例：yyyyMMdd）<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项（以分为单位，不带小数点）<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><TRXTYPE>交易类型</TRXTYPE> 中文<BUSIDATE>交易日期</BUSIDATE> yyyyMMdd<BUSITIME>交易时间</BUSITIME> HH:mm:ss<Account_num>交易帐号</Account_num><Bank_name>本方行名</Bank_name><Trans_type>业务种类</Trans_type> 中文<sign>借贷标志</sign> 中文<Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Yt>用途</Yt><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><RECIPACT>对方帐号</RECIPACT><RECIPNAME>对方户名</RECIPNAME><RECIPBNA>对方行名</RECIPBNA><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>2转帐支付（逐笔）支付提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name>汇款单位</Pay_Dep_name><Pay_Dep_Acc>汇款帐号</Pay_Dep_Acc> （35位）---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>汇款单位开户行</Pay_Dep_branch><Rec_Dep_name>收款单位</Rec_Dep_name> （60位） ---必输项<Rec_Dep_Acc>收款帐号</Rec_Dep_Acc> （35位） ---必输项<Rec_Area_Code>收款人地区代码</Rec_Area_Code> 0：它行 1：工行<Rec_Dep_branch>收款单位开户行</Rec_Dep_branch>（60位）--必输项<Trans_time>交易时间</Trans_time><Serial_no>指令序号</Serial_no><PayAmt>金额</PayAmt> （18位） ---必输项以分为单位<Account_cur>币种</Account_cur><Pay_Use>用途</Pay_Use> （20位）<Pay_type>汇款速度</Pay_type> 0：普通 1：加急<Author_log_id_1>授权人ID</Author_log_id_1><Author_log_id_2>二次授权人ID</Author_log_id_2><Submit_Log_id>提交人ID</Submit_Log_id> ---必输项 <Area_name>付款人账户地区名(付款人所在地) </Area_name><Rec_Area_name>收款人账户地区名(收款人所在地) </Rec_Area_name>---必输项收方如果是工行，以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code><Pay_Password>支付密码</Pay_Password><User_Rem>备注栏(用户备注) </User_Rem><Pay_NetCode>付款行网点号</Pay_NetCode><Pay_BranchNo>付款行行号</Pay_BranchNo><Pay_BranchId>付款行行标识</Pay_BranchId><Pay_DispsNo>付款行分签号</Pay_DispsNo><Rec_BranchNo>对方行号</Rec_BranchNo><Rec_BranchId>对方行标识</Rec_BranchId><Rec_DispsNo>对方分签号</Rec_DispsNo><PostScript>附言</PostScript><PostScriptFlag>附言标志</PostScriptFlag><Transfer_Type>转帐类型</Transfer_Type><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID（15位）</PackageID> ---必输项<SignTime>签名时间（yyyyMMddhhmmssSSS）</SignTime> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>支付返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode>返回码</retCode>0-成功1-可疑其他为失败，错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag>成功描述</TranFlag><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>逐笔支付查询提交包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName><ReqParam><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项（提交指令中的包ID）<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="1.0" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode>此值只表示该交易是否执行成功，并不代表此笔支付是否成功或失败（非空表示交易执行失败，失败原因见errMsg）。

利⽤⾃定义异常来重构代码（▄︻┻┳═⼀不了解⾃定义异常者勿看）▄︻┻┳═⼀『异常捕获系列』Agenda：▄︻┻┳═⼀▄︻┻┳═⼀▄︻┻┳═⼀##先贴出来代码项⽬中有个页⾯，⽤来⽀付回调。

窗体⾥⽆任何html元素。

服务端程序Page_Load如下，即获取到请求的订单，校验订单是否有效，然后持久化订单数据，并回写处理成功或失败的标识。

1///<summary>2///由PayAndRefund/RefundForm.aspx请求过来，处理业务系统的退款请求3///</summary>4public partial class RefundForm : System.Web.UI.Page5 {6private AlipayPaymentBLL.AlipayBLL obll = new AlipayPaymentBLL.AlipayBLL();7private AlipayPaymentBLL.AlipayRefundRecord alipayRefundBll = new AlipayPaymentBLL.AlipayRefundRecord();8protected void Page_Load(object sender, EventArgs e)9 {10// 记录⽇志和相关标记11 CommonUtils.LogCommon.instance.writePay(this, "==================================================================================="); 12string sMsg = UrlInfo.Initial(Request).GetMsg();13 CommonUtils.LogCommon.instance.writePay(this, sMsg);1415 ReturnValue result;16try17 {18string reqStr = WebCommon.ReadStreamReqStr(Request, System.Text.Encoding.UTF8);//获得流序列化19var refundApply = JsonConvert.DeserializeObject<CommonModel.Domains.RefundApplyDTO>(reqStr);20if (refundApply == null)21 {22 result = new ReturnValue("9999", "⽆通知参数");23 }24else25 {26var dt = new DataTable();27var listOrderNo = new List<string>();28var dicMoney = new Dictionary<string, string>();29var dicRemark = new Dictionary<string, string>();30 result = alipayRefundBll.BuilderArray(listOrderNo, dicMoney, dicRemark, refundApply);//解析传⼊参数信息31if (result.Code == "0000")32 {33 result = new AlipayPaymentBLL.AlipayRefundRecord().CheckRefundRecordOrder(listOrderNo, refundApply);34if (result.Code == "0000")35 {36 result = alipayRefundBll.DoRefund(refundApply, dt, listOrderNo, dicMoney, dicRemark);37if (result.Code == "0000")38 {39 dt.Columns.Remove("trade_no");40string[] sTableColumName = monFun.GetColumNameOfDataTable(dt);41// 将退款数据批量insert到dbo.T_AlipayRefundRecord42// ⽀付宝退款是有密的，这⾥只保存。

微信退款API的操作⽅法⾸先我们需要申请到商户的key密钥这个是在账号关联（AppID绑定）应⽤场景当交易发⽣之后⼀段时间内，由于买家或者卖家的原因需要退款时，卖家可以通过退款接⼝将⽀付款退还给买家，微信⽀付将在收到退款请求并且验证成功之后，按照退款规则将⽀付款按原路退到买家账号上。

注意：1、交易时间超过⼀年的订单⽆法提交退款2、微信⽀付退款⽀持单笔交易分多次退款，多次退款需要提交原⽀付订单的商户订单号和设置不同的退款单号。

申请退款总⾦额不能超过订单⾦额。

⼀笔退款失败后重新提交，请不要更换退款单号，请使⽤原商户退款单号3、请求频率限制：150qps，即每秒钟正常的申请退款请求次数不超过150次4、每个⽀付订单的部分退款次数不能超过50次5、如果同⼀个⽤户有多笔退款，建议分不同批次进⾏退款，避免并发退款导致退款失败6、申请退款接⼝的返回仅代表业务的受理情况，具体退款是否成功，需要通过退款查询接⼝获取结果。

7、⼀个⽉之前的订单申请退款频率限制为：5000/min接⼝地址我们退款的时候需要注意要准备证书使⽤，在⽀付的时候不是必要条件需要证书请求需要双向证书。

⼀、超级管理员扫码登录微信⽀付商户平台后，进⼊账户中⼼找到API安全；点击申请证书，跳出⽣成API证书界⾯。

点击“允许访问”，同意⽹页访问剪切板；三、下载证书⼯具，在证书⼯具中点击“申请证书”按钮；四、按照要求填写商户信息，点击下⼀步；五、复制请求串到剪切板，在之前的⽣成API证书界⾯粘贴，输⼊“短信验证码”和“登录密码”；点击下⼀步，进⼊复制证书串界⾯。

六、复制证书串到剪切板，在证书⼯具的粘贴证书串界⾯，点击粘贴按钮。

然后进⼊下⼀步，⽣成证书。

七、⽣成证书之后，找到下载到电脑的证书⽂件，改个好认的名字发给技术⼈员，记得保留⼀个备份。

技术⼈员获得证书之后将证书部署到服务器上。

也就完成了微信⽀付与微信公众号等平台的对接了。

下⾯是请求时需要的参字段名变量名必填类型⽰例值描述公众账号ID appid是String(32)wx8888888888888888微信分配的公众账号ID（企业号corpid即为此appid）商户号mch_id是String(32)1900000109微信⽀付分配的商户号随机字符串nonce_str是String(32)5K8264ILTKCH16CQ2502SI8ZNMTM67VS随机字符串，不长于32位。

支付宝（当面付）接入与使用说明相关接口列表统一下单并支付接口(alipay.acquire.createandpay) 统一预下单接口(alipay.acquire.precreate) 收单查询接口(alipay.acquire.query)收单退款接口(alipay.acquire.refund)收单撤销接口(alipay.acquire.cancel)版本号：1.0支付宝（中国）网络技术有限公司版权所有目录1 产品说明 (3)1.1 商户端终端 (3)1.1.1扫码支付（也称二维码支付） (3)1.1.2 条码支付（也称一维码支付） (3)1.1.3 声波支付 (4)1.2 用户端设备 (4)1.2.1 手机 (4)1.3 完整流程 (6)1.4 名词解释 (13)2 集成流程详解 (14)2.1 接入准备 (14)2.2 集成 (14)2.2.1 接口开发顺序 (14)2.2.2 安全保障 (16)3 测试流程规则 (16)4 附录 (16)4.1 如何获得PID与密钥 (16)1 产品说明1.1 商户端终端1.1.1 扫码支付（也称二维码支付）两种方式1. 双屏显示器，用于给用户显示二维码2. 终端POS机支持热敏打印，把二维码打印在小票1.1.2 条码支付（也称一维码支付）1. 红外扫码枪，用于扫描用户手机中支付宝客户端的条形码1.1.3 声波支付1. 普通麦克风1.2 用户端设备1.2.1 手机1. 安装了支付宝钱包（建议8.0版本以上）2.3. 当商户端选择“扫码支付”，用户需要在客户端里点击“扫一扫”，上图左上角4. 当商户端选择“条码支付”，用户需要在客户端里点击“付款码”，上图右上角图中显示的是用户的二维码，条码下面的数字就代表该条码和二维码具体的值，该值就是接口参数中的“动态ID”5. 当商户端选择“声波支付”，用户需要在客户端里点击“当面付”第二行菜单最右边用户把手机的扬声器对准商户的麦克风，商户识别并解析该声波频率后就把结果赋值给“动态ID”参数1.3 完整交易流程仅限条码支付和扫码支付流程图以上都是正常流程，当用户需要退款或者是交易失败情况的流程如下：2 集成流程详解2.1 接入准备1. 确认是否作为渠道商或者系统商接入确认是否和支付宝的商务经理签署渠道产品返佣协议。

快钱快钱【【人民币支付网关人民币支付网关】】商户退款接口规范上海快钱信息服务有限公司目录1. 文档说明 (3)1.1 文档目标 (3)1.2 阅读对象 (3)1.3 相关约定 (3)1.4 技术支持 (3)2. 接口开发 (4)2.1 功能说明及流程 (4)2.2 开发准备 (4)2.3 参数说明 (4)2.3.1 商户提交到快钱 (4)2.3.2 快钱返回到商户 (5)2.4 开发提示 (6)2.4.1 签名字符串 (6)2.4.2 通知退款结果 (6)2.4.3 快钱对退款订单的处理 (6)3. 参考资料 (6)3.1 常见问题 (6)3.1.1 如何获取商户编号 (6)3.1.2 如何获取或修改退款密钥 (7)3.1.3 如何查询退款交易记录 (7)3.2 错误提示信息 (7)4 附录 (8)4.1 版权说明 (8)4.2 快钱资源 (8)1. 文档说明1.1 文档目标本文档的目的是为快钱人民币网关商户退款接口定义规范，以帮助商户技术人员接入，并快速掌握相关功能，便于尽快投入使用。

1.2 阅读对象快钱商户及合作伙伴的网上应用开发人员、维护人员和管理人员。

他们应具备以下基本知识：了解MICROSOFT WINDOWS/NT、WINDOWS9X、WINDOWS 2000、HP-UX、AIX、SUN SOLARIS、LINUX、BSD等操作系统的其中一种；了解上述系统上的网站设置和网页制作方法；熟悉CGI、ASP、PHP、.NET、JAVA 以及HTML、XML等开发语言及技术；了解信息安全的基本概念。

1.3 相关约定相关约定商户：指已注册成为快钱用户、并使用快钱产品实现其收付费功能需求、为其用户提供各类产品或者服务的企业或个人。

在本接口说明中指退款方。

用户：指在商户网站等系统购物的企业或个人。

在本接口说明中指收款方退款：指商户将购买产品或服务的款项全部或部分退还给用户。

{XXX}：XXX前后分别加{和}，表示名称为XXX的变量所对应的值。

外部接口名称：即时到账批量退款接口服务名: refund_fastpay_by_platform_pwd修订历史版本号修订章节修订原因修订日期1.0全部起草2009-08-271.1部分外部接口文档统一梳理2010-03-14版权信息本手册中所有的信息都是支付宝公司的财产并且受到严格的保密。

未经过支付宝公司书面同意，接收本手册的人不能复制，公开，泄露手册的部分或全部的内容。

1、术语2、功能描述接收外部合作伙伴批量即时到账退款请求,需要页面输入密码确认。

当请求被接受,注册定时任务异步处理该批退款请求,全部完成后以通知方式告知外部合作伙伴。

3、访问形式页面调用4、请求输入参数表5、请求URL样例https:///cooperate/gateway.do?service=refund_fastpay_by_platform_pwd&partner=654851222&_i nput_charset=utf-8&sign_type=DSA&sign=dergdjv1gh0894q2gcjq447tcyn4dr3i1&seller_email=abc%&seller_user_id=%E6 %97%A0&refund_date=%E6%97%A0&batch_no=%E6%97%A0&batch_num=%E6%97%A0&detail_data=20080 32602676583%5E100%5E%E9%80%80%E4%BA%A4%E6%98%93%232008032602676584%5E10%5E%E9%80%8 0%E4%BA%A4%E6%98%93&notify_url=http%3A%2F%%2Fnotify%2Falipay%2Finterface.htm6、请求输出参数6.1 通知返回的参数列表6.2 跳转URL样例/api/apireceive/returnSuccess.php?notify_time=2009-08-12+11%3A08%3A32&notify_type=batch_refund_notify&notify_id=70fec0c2730b27528665af4517c27b95&sign_ty pe=DSA&sign=_p_w_l_h_j0b_gd_aejia7n_ko4_m%252Fu_w_jd3_nx_s_k_mxus9_hoxg_y_r_lunli_pmma29_t_q %3D%3D&batch_no=20060702001&success_num=2&result_details=2010031906272929%5E80%5ESUCCESS6.3 页面跳转返回的参数列表跳转URL样例/api/apireceive/returnDisplay.php?detailTradeNO=%E6%97%A06.4 错误代码7、注意事项1) 此接口只支持https请求，详见请求url样例。

物流⼀站式查询之顺丰接⼝篇连载篇提前看前情提要本篇内容承接上篇《⽂末所说，顺丰物流关闭了对第三⽅的物流接⼝，导致众多第三⽅物流平台查询不到顺丰快递的物流信息。

但是问题终归是要解决滴，别家不⾏，咱就直接⽤顺丰⾃家的。

原本⽹上找顺丰物流信息查询发现看了下介绍，因为也是顺丰的平台，也没多想，看到流程还是⽐较清晰的。

本来想找在线客服咨询下，结果发现在线客服有的只是⼀个群号，⽽且还不能加⼈了，于是乎就按照接⼊流程开始操作，本地都开发的差不多了，后来意外联系到⼀个顺丰的IT⼈员，通过他得知，顺丰物流信息接⼝已经转到另⼀个部门和平台操作了，这个开放平台已经⼏乎没有⼈维护了。

于是再他的协助下，我得到了最新的对接⽂档。

按找新⽂档，之前的开发的全部得重写，请求接⼝不⼀样，数据传输和接收⽅式不⼀样，由开放平台的Json格式到现在⽤XML传输。

这⾥贴⼀下接⼊规范⽂档的⽬录顺便提⼀下顺丰路由查询接⼝就是查询物流信息的接⼝，不过再顺丰平台使⽤此接⼝有个前提条件，就是必须是顺丰的⽉结⽤户。

登陆可以查看到基本信息注：①不是顺丰⽉结卡⽤户或者企业，不能接⼊路由查询②不是通过顺丰接⼝下单的运单号，不能接⼊路由推送接⼝，换⽽⾔之，如果是通过顺丰⼤客户发货系统或者其他⽅式进⾏的打单获取到的快递单号，⽆法对此单进⾏订阅推送操作。

开发篇看完基本流程和接⼊规范之后，就可以按照⽂档规范进⾏编码。

因为⽬前我只⽤到了标红的三个接⼝，所以接下来对这三个接⼝⼀⼀讲解。

(注开发之前本机IP需要得到官⽅授权，不然会请求会返回IP未授权)下单接⼝1.1. 功能描述下订单接⼝根据客户需要，可提供以下三个功能：1) 客户系统向顺丰下发订单。

2) 为订单分配运单号。

3) 筛单（可选，具体商务沟通中双⽅约定，由顺丰内部为客户配置）。

此接⼝也⽤于路由推送注册。

客户的顺丰运单号不是通过此下订单接⼝获取，但却需要获取BSP的路由推送时，需要通过此接⼝对相应的顺丰运单进⾏注册以使⽤BSP的路由推送接⼝。

UniApp+SpringBoot实现⽀付宝⽀付和退款开发准备⼀台⽤于⽀付的测试机⽤于编写的后端框架接⼝的 IDE （IDEA 或者Eclipse 都可以）HBuilder X ⽤来编辑 UniApp 项⽬的编辑器和编译器基本的 SpringBoot 的脚⼿架，可以去或者 IDEA ⾃带的快速⽣成脚⼿架插件。

Jdk 11⽀付宝⽀付开发后端部分在 SpringBoot 中添加以下坐标<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- ⽀付宝官⽅ SDK--><dependency><groupId>com.alipay.sdk</groupId><artifactId>alipay-sdk-java</artifactId><version>4.22.32.ALL</version></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-configuration-processor</artifactId><optional>true</optional></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency>在 resources ⽬录下添加 application.yml 我们不去⽤默认的⽂件，毕竟 yml 更好看点。