统一下单

应用场景

除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,返回正确的预支付交易回话标识后再按扫码、JSAPI、APP等不同场景生成交易串调起支付。

接口地址

https://www.epaylinks.cn/paycenter/v2.0/getoi.do

输入参数

通过get或post请求

参数 参数名称 类型 必填 描述
协议参数
version 接口版本 String(8) 固定填写4.0
sign_type 签名类型 String(20) 目前支持SHA256withRSA签名算法
certId 证书序列号 String(500) 填写签名私钥证书的Serial Number
sign 签名 String(500) 数字签名
业务参数
partner 商户号 String(20) 由易票联统一分配的商户号
out_trade_no 商户系统订单号 String(32) 商户系统生成的唯一订单号。仅可以使用大小写英文字符、数字、下划线、中划线组成。
(易票联根据商户编码和这个订单号,保证其在网关系统的订单唯一性)
total_fee 订单金额 String(12) 格式:元.角分,单位是元,最大8位整数,2位小数
currency_type 货币代码 String(3) 货币代码
人民币:RMB
港币:HKD
美元:USD
notify_url 后台通知URL String(500) 用于接收易票联后台发送的支付结果通知的URL
order_create_ip 订单创建IP String(30) 订单生成的机器IP,指用户浏览器端IP,不是商户服务器IP
pay_id 支付方式 String(20) wxNative: 微信扫码支付
base64_memo 商品名称 String(200) 商品名称(需要进行BASE64编码,以GBK方式,进行BASE64编码)
如:base64(保温杯)= saPOwrGt
store_oi_type 网关类型 String(1) 支付接口收单类型,分web网页版和手机wap版,0:网页版(默认),1:手机版
time_out 订单超时时间 String(14) 设置未付款交易的截止时间,一旦达到截止时间,该笔交易就会自动被关闭。为空则默认45分钟。格式:yyyyMMddHHmmss
time_limit 二维码失效时间
(分钟)
Int 二维码失效时间,需大于1分钟。当pay_id为wxNative为必输项
is_raw 是否原生态 int 公众号支付时,为必填,并且固定填写1
sub_openid 用户openid Sring(128) 公众号支付时,为必填
微信用户关注商家公众号的openid。
如何获取openId?
sub_appid 公众账号appid Sring(128) 公众号支付时,为必填
微信公众号支付时,值是微信公众平台基本配置中的AppID(应用ID)
如何查看appid?

举例如下:

https://www.epaylinks.cn/paycenter/v2.0/getoi.do?auth_code=&base64_memo=suLK1LG416LQxc%2Bi&busi_type=&card_type=&certId=335902764374016746163578510918738695929360058949&curr_version=null¤cy_type=RMB&easecardAccount=&epay_card_number=&merchant_account=¬ify_url=http%3A%2F%2F14.23.90.101%3A80%2Fpaycenter%2FTestPayCenter%2Fgateways%2Fv40%2FnotifyUrl.jsp&order_create_ip=&out_trade_no=1502241300229&partner=EC130422C0003&pay_id=wxNative&return_url=http%3A%2F%2F14.23.90.101%3A80%2Fpaycenter%2FTestPayCenter%2Fgateways%2Fv40%2FreturnUrl.jsp&sign=DxWeMiKx4zWZ%2FKgT%2FTzqghhBQ2z8ESa%2BFprnDnsyM3MtGBplWpTz10uDNM9DkU9Nl3MpqUFO6dLdbvu20k%2BgpKiH0JQOZc0W%2BIHE66M4HXK4sKYwjeaU%2BdxXKC8mP2vT5fKtSM6P5GD7f9laHRsc9jvMRUjYu1DnizlXWz3H6tXh4CqFCBflgYhRutL2and6HYh%2FZJlwhy%2FQpJ%2BwItoK307tZAZepidxFuS%2FI9fh1wGsbQ8cX%2F64Vb%2B%2FEIzDk%2BVfvFpyDAJlpRDTOAM49qtOrlB9w%2B%2Bcg1KbojNE8QdE6Uf88lAJxm4PTlX%2FyYJgJ0Oys4iiSNV6k%2Bl6E7HE%2BZ4k7w%3D%3D&sign_type=SHA256withRSA&store_oi_type=0&time_limit=60&time_out=&total_fee=0.01&version=4.0

返回结果

数据按XML的格式实时返回

参数 参数名称 类型 必填 描述
协议参数
version 接口版本 String(8) 固定填写4.0
sign_type 签名类型 String(20) 目前支持SHA256withRSA签名算法
certId 证书序列号 String(500) 填写签名私钥证书的Serial Number
sign 签名 String(500) 数字签名
业务参数
respCode 响应码 String(2) 00表示成功,其它表示失败
respDesc 响应描述 String(100) 响应描述
partner 商户号 String(20) 由易票联统一分配的商户号
out_trade_no 商户系统订单号 String(20) 支付网关通过商户编码和这个订单号,保证网关系统的订单唯一性。
原样返回请求参数列表中的out_trade_no
curr_code 货币代码 String(3) 货币代码,人民币:RMB;港币:HKD;美元:USD
原样返回请求参数列表中的currency_type
pay_no 支付单号 String(24) 网关系统支付单号
amount 订单金额 String(12) 格式:元.角分,单位是元
原样返回请求参数列表中的total_fee
prepay_id 预支付 ID String(64) 当pay_id为wxNative、wxAppPay时返回。
code_url 二维码链接 String(200) 此参数可直接生成二维码展示出来进行扫码支付
time_limit 二维码失效时间 Int
channelSerialNo 上游订单号 String(12)
pay_info 原生态js支付信息 String(256) 公众号支付,并且is_raw=1时返回。
作用于原生态js支付时的参数,为json格式的字符串
详见 pay_info说明

举例如下:

<?xml version="1.0" encoding="GBK" ?>
<root>
   <respCode>00<respCode>
   <respDesc>成功</respDesc>
   <tranAmount/>
   <disAmount/>
   <suppInfo/>
   <partner>EC130422C0003</partner>
  <out_trade_no>1502241300229</out_trade_no>
   <curr_code>RMB</curr_code>
  <amount>0.01</amount>
  <pay_no>10946619</pay_no>
  <trade_type/>
  <prepay_id/>
  <code_url>weixin://wxpay/bizpayurl?pr=EuXILUt</code_url>
  <time_limit/>
  <sign_type>SHA256withRSA</sign_type>
  <sign>
  <n+9vsQAnMNieFNKtjJ/EEnkq/IbjBOpfhV66rZXNywbwHQbcnALFGowz23mRSFHCuZgNKEgJ+Bv7g8C/xOUFLSZCIQr5ZbUqiRIrFbym05QXHONFW5xdEekDJEOfxzucoJd4YGl/MyOyrpWIvOoV5yjOGiuNARQE17Z9KUXK9mEGdnQh0VifjRELCKP9qU9EJ+V0V4T+MF8Crt2lasyuLpk+ANdEDTTs7iK5Ua4QqmvQpb4XkwI56iMc37DHDTWBF4wKaNPVDt6iOv3fb4uuDpHjVYJgjRuiS8ThoymyTHo1dJMKTPtDkuVLW9r+Kur/FZmPjw3x7ajUWpbTG31CwA== </sign>
</root>