三峡付微信/支付宝预下单接口文档1. 概述本说明书描述商户系统接入三峡付微信扫码支付、微信APP支付、微信被扫支付、支付宝扫码支付、支付宝被扫支付,三峡付被扫支付，银联被扫支付的说明文档。微信APP端开发步骤参考：https:/pay.weixin.qq.com/wiki/doc/api/app/app_sl.php?chapter=8_5微信APP支付官方SDK与DEMO参考：https:/pay.weixin.qq.com/wiki/doc/api/app/app_sl.php?chapter=11_12. 交互定义2.1 交互机制系统采用请求应答模式，在请求-应答模式下，一方作为服务提供者，另一方作为服务使用者。由服务使用者主动向服务提供者发起请求并等待应答，服务提供者接受请求，完成处理，并向服务使用者应答处理结果，服务使用者收到处理结果之后进行后续处理。2.2 交互协议方式支付接口测试环境采用HTTP协议，生产环境采用HTTPS协议。所有参数都使用POST提交。3. 接口定义3.1 支付预下单请求参数说明沙盒环境请求URL：http:/222.178.75.14:8082/epaygate/wechatPaymentApi.htm?生产环境请求URL：https:/www.sanxiapay.com/epaygate/wechatPaymentApi.htm?Json对象 payment参数列表：支付payment参数列表：字段名变量名必填类型说明不用加密参数商户号partner是String(15)商户号,由三峡付统一分配的8-10位正整数(120XXXXXXX)加密参数 orderInfo订单信息商户订单号out_trade_no是String(32)商户系统内部的订单号,32个字符内、可包含字母,确保在商户系统唯一。（退款交易查询时，则是退款发起交易的退款单号）商品名称subject是String(250)商品名称商品描述body否String(250) 对一笔交易的具体描述信息。如果是多种商品，请将商品描述字符串累加传给body。 总金额total_fee是number订单总金额，单位为元，如：1.23或1.00测试环境微信支付使用固定金额NATIVE:3.01MICROPAY:0.01APP:2.01币种fee_type是String币种，默认值：1-人民币，暂只支持1-人民币用户IPspbill_create_ip是String(15)订单生成的机器IP，指用户浏览器端IP不是商户服务器IP异步通知路径notify_url是String(255)服务器主动通知商户网站里指定的页面http 路径。(银联被扫支付不填写)支付渠道trade_channel是String默认：WECHAT 微信ALIPAY：支付宝UNIONPAY：银联（被扫支付）SANXIAPAY：三峡付支付（被扫支付）支付方式trade_type是String默认： APP-APP支付NATIVE：扫码支付MICROPAY：被扫支付MWEB：微信H5支付JSXCX:小程序支付付款码authCode否String用户付款码：支付方式为MICROPAY时必传用户唯一标识openid否String小程序支付时，必传是否允许退款is_refund是String0允许退款1不允许退款退款有效期refund_period否String(17)订单最迟退款时间，格式为yyyyMMdd hh:mm:ss。商户退款最后期限；当“是否允许退款”值为“0”时，不传默认一个月业务类型business_type是String支付业务类型，参考文档：三峡付网关商户接入手册 章节6.2.4 business_type参数说明收银员编号operid否String银联被扫支付时传经度信息longitude否String 银联被扫支付时传 格式:3位整数+1位小数点+6位小数维度信息latitude否String银联被扫支付时传 格式:1位正负号+2位整数+1位+1位小数点+6位小数终端序列号serialNum否String银联被扫支付时传 终端设备的硬件序列号分账标识accFLag否String1为分账，如果为1时，分账明细必输分账明细accRecord否String格式：账户名称1|账号1|金额1|手续费收取标识1（0-否，1-是）, 账户名称2|账号2|金额2|手续费收取标识2扩展字段attach否String备注字段3.2 支付预下单请求返回参数说明字段名变量名必填类型说明返回结果retCode是Stringsuccess-下单请求成功；error-下单请求失败；结果说明retShow否String当result为“error-下单失败”时，说明原因下单成功返回参数data否Map当result为“success-下单成功”时，返回下单成功参数体data下单成功订单信息商户应用IDappId否String微信（APP支付、小程序）：商户应用ID微信APP支付子商户号partnerid否String微信（APP支付、小程序）：子商户号扩展字段packages否String微信（APP支付、小程序）：扩展字段随机字符串nonceStr否String微信（APP支付、小程序）：随机字符串签名paySign否String微信（APP支付、小程序）：支付参数加密生成签名预支付交易会话IDprepayid否String微信（APP支付、小程序）：请求发起微信支付预支付交易会话ID时间戳timeStamp否String微信（APP支付、小程序）：时间戳预下单二维码内容codeStr否String扫码支付返回：以此内容生成二维码订单金额payMoney否String订单金额通道交易订单号tradeNo否StringMICROPAY被扫支付/支付宝小程序支付时返回：银联/微信/支付宝交易订单号订单流水号plat_transno否String支付流水号（三峡付被扫返回）用于后续查询订单支付状态注意：1.支付结果务必以异步通知结果为准，同步返回只做状态显示；2.MICROPAY被扫支付时，retCode为success时，代表下单成功，且扣款成功，订单交易状态为成功。3.三峡付被扫支付时，retCode为success时，只代表下单成功，不代表支付结果，后续需要调用查询订单接口查询订单的支付状态3.3 异步应答通知参数列表三峡付在处理完用户的支付后，会将处理的结果通过用户浏览器跳转的方式，将数据传递给商户系统；注意：retcode参数表示的是交易本身的应答，即这个动作是否成功，不代表交易的状态；若交易动作成功，即应答码为“0”，则根据“交易状态”即trade_state来判断交易是否成功；支付接口（返回结果和通知参数列表）：字段名变量名必填类型说明协议参数接口名称service否String（100）接口名称（pay_service） 接口版本service_version否String(8)版本号，默认为1.0字符集input_charset否String(8)字符编码,取值：UTF-8签名方式sign_type否String(20)签名类型，取值：SHA1withRSA签名sign否String(344)签名商户号partner否String(15)商户号,由三峡付统一分配的8-10位正整数(120XXXXXXX)业务参数返回状态码retcode是Int返回状态码，0表示成功，其他参考返回结果代码列表返回消息retmsg否String返回消息，通常返回错误信息交易模式trade_mode是String（10） 0002-即时到账交易状态trade_state是Int支付结果：0成功 1失败 3-处理中支付结果信息pay_info否String(64)支付结果信息，支付成功时为空支付渠道trans_channel否String（5）pc-电脑商户订单号out_trade_no是String(32)商户系统内部的订单号,32个字符内、可包含字母,确保在商户系统唯一。平台订单号transaction_id是String(32)三峡付平台系统流水号当日日期+流水号序列 自动生成唯一总金额total_fee是number支付金额，单位为元，如果discount有值，通知的total_fee + discount = 请求的total_fee通知IDnotify_id否String(128)支付结果通知id，商户收到支付结果时，通过通知id查询接口验证信息是否来自三峡付支付完成时间time_end是String(17)支付完成时间，格式为yyyyMMdd hh：mm：ss。该时间取自三峡付服务器物流费用transport_fee否number物流费用，单位为元，如果有值，必须保证transport_fee + product_fee = total_fee物品费用product_fee否number物品费用，单位为元。如果有值，必须保证transport_fee + product_fee=total_fee折扣价格discount否number折扣价格，单位为元，如果有值，通知的total_fee + discount = 请求的total_fee附加数据attach否String(250)商家附加数据，原样返回异步通知时，取商户在支付时提交的notify_url字段加参数notify返回，如：https:/127.0.0.1/notifyurl.do?notify=AES加密报文;3.4 商户后台通知反馈三峡付在处理完用户的支付后，会将处理的结果通过服务器主动调用商户的系统提供的url，将数据传递给商户系统,此通知不依赖用户的浏览器后台通知结果反馈：返回结果结果说明success处理成功，三峡付系统收到此结果后不再进行后续通知fail或其它字符处理不成功，三峡付收到此结果或者没有收到任何结果，系统通过补单机制再次通知，对后台通知交互模式，如果三峡付收到商户系统的应答不是success或超时，三峡付系统认为通知失败，三峡付会通过一定的策略（如1小时共8次）定期重新发起通知，尽可能提高通知的成功率,但三峡付不保证通知最