应用场景
除被扫支付场景以外,商户系统先调用该接口在微信支付服务后台生成预支付交易单,返回正确的预支付交易回话标识后再按扫码、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>