NopCommerce Alipay 支付插件
1.查找及下载NopCommerce Alipay插件
http://www.nopcommerce.com/p/963/alipay-payment-module-nopcommerce-team.aspx
2.解压并添加到项目
按照Readme.txt
1. 'Nop.Plugin.Payments.AliPay' directory contains source code.
2. 'Payments.AliPay' contains binaries. Just drop it into \Plugins directory on your server.
将相应的3.80文件夹下的文件 放置指定位置
Payments.AliPay -》 nopCommerce_3.80\Presentation\Nop.Web\Plugins
Nop.Plugin.Payments.AliPay -》nopCommerce_3.80\Plugins
在解决方案的Plugins Add Existing Item
Nop.Plugin.Payments.AliPay.AliPayPaymentProcessor
/// <summary> /// Post process payment (used by payment gateways that require redirecting to a third-party URL) /// </summary> /// <param name="postProcessPaymentRequest">Payment info required for an order processing</param> public void PostProcessPayment(PostProcessPaymentRequest postProcessPaymentRequest) { //string gateway = "https://www.alipay.com/cooperate/gateway.do?"; var sellerEmail = _aliPayPaymentSettings.SellerEmail; var key = _aliPayPaymentSettings.Key; var partner = _aliPayPaymentSettings.Partner; var outTradeNo = postProcessPaymentRequest.Order.Id.ToString(); var subject = _storeContext.CurrentStore.Name; var body = "Order from " + _storeContext.CurrentStore.Name; var totalFee = postProcessPaymentRequest.Order.OrderTotal.ToString("0.00", CultureInfo.InvariantCulture); var notifyUrl = _webHelper.GetStoreLocation(false) + "Plugins/PaymentAliPay/Notify"; var returnUrl = _webHelper.GetStoreLocation(false) + "Plugins/PaymentAliPay/Return"; string[] para ={ "service=" + Service, "partner=" + partner, "seller_email=" + sellerEmail, "out_trade_no=" + outTradeNo, "subject=" + subject, "body=" + body, "total_fee=" + totalFee, "show_url=" + ShowUrl, "payment_type=1", "notify_url=" + notifyUrl, "return_url=" + returnUrl, "_input_charset=" + InputCharset }; var aliayUrl = CreatUrl(para, InputCharset, key); var post = new RemotePost { FormName = "alipaysubmit", Url = "https://www.alipay.com/cooperate/gateway.do?_input_charset=utf-8", Method = "POST" }; post.Add("service", Service); post.Add("partner", partner); post.Add("seller_email", sellerEmail); post.Add("out_trade_no", outTradeNo); post.Add("subject", subject); post.Add("body", body); post.Add("total_fee", totalFee); post.Add("show_url", ShowUrl); post.Add("return_url", returnUrl); post.Add("notify_url", notifyUrl); post.Add("payment_type", "1"); post.Add("sign", aliayUrl); post.Add("sign_type", SignType); post.Post(); }
Alipay请求参数说明
https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103740&docType=1
解决方案 Clean 和 Rebuild
运行站点
3.安装插件
Admin -> Configuration -> Plugins -> Local plugins
4.配置插件
Admin -> Configuration -> Payment -> Payment methods -> Configure
aliPay_partner:商户PID
aliPay_seller:商户支付宝
aliPay_rsaPriKey:生成的private_key
aliPay_rsaPubKey:生成的public_key
http://docs.apicloud.com/Client-API/Open-SDK/aliPay
https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103740&docType=1
配置信息将保存在Setting表中
5.启用插件
Admin -> Configuration -> Payment -> Payment methods -> Edit
6.前台查看
附 Alipay请求参数说明
https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103740&docType=1
请求参数说明
请求参数是商户在与支付宝进行数据交互时,提供给支付宝的请求数据,以便支付宝根据这些数据进一步处理。
参数 | 参数名称 | 类型(字节长度) | 参数说明 | 是否可为空 | 样例 |
基本参数 | |||||
service | 接口名称 | String | 接口名称。 | 不可空 | create_direct_pay_by_user |
partner | 合作者身份ID | String(16) | 签约的支付宝账号对应的支付宝唯一用户号。 以2088开头的16位纯数字组成。 | 不可空 | 2088101011913539 |
_input_charset | 参数编码字符集 | String | 商户网站使用的编码格式,如utf-8、gbk、gb2312等。 | 不可空 | gbk |
sign_type | 签名方式 | String | DSA、RSA、MD5三个值可选,必须大写。 | 不可空 | MD5 |
sign | 签名 | String | 请参见本文档“附录:签名与验签”。 | 不可空 | 7d314d22efba4f336fb187697793b9d2 |
notify_url | 服务器异步通知页面路径 | String(190) | 支付宝服务器主动通知商户网站里指定的页面http路径。 | 可空 | http://api.test.alipay.net/atinterface/receive_return.htm |
return_url | 页面跳转同步通知页面路径 | String(200) | 支付宝处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。 | 可空 | http://api.test.alipay.net/atinterface/receive_return.htm |
业务参数 | |||||
out_trade_no | 商户网站唯一订单号 | String(64) | 支付宝合作商户网站唯一订单号。 | 不可空 | 6843192280647118 |
subject | 商品名称 | String(256) | 商品的标题/交易标题/订单标题/订单关键字等。 该参数最长为128个汉字。 | 不可空 | 贝尔金护腕式 |
payment_type | 支付类型 | String(4) | 只支持取值为1(商品购买)。 | 不可空 | 1 |
total_fee | 交易金额 | Number | 该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。 | 不可空 | 100 |
seller_id | 卖家支付宝用户号 | String(16) |
三个参数至少必须传递一个。 当签约账号就是收款账号时,请务必使用参数seller_id,即seller_id的值与partner的值相同。 三个参数的优先级别是:seller_id>seller_account_name>seller_email。 | 不可空 | 2088002007018966 |
seller_email | 卖家支付宝账号 | String(100) | alipay-test01@alipay.com | ||
seller_account_name | 卖家支付宝账号别名 | String(100) | tstable02@alipay.com | ||
buyer_id | 买家支付宝用户号 | String(16) |
三个参数的优先级别是:buyer_id>buyer_account_name>buyer_email。 | 可空 | 2088002007018955 |
buyer_email | 买家支付宝账号 | String(100) | tstable01@alipay.com | ||
buyer_account_name | 买家支付宝账号别名 | String(100) | tstable03@alipay.com | ||
price | 商品单价 | Number | 单位为:RMB Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。此参数为单价 规则:price、quantity能代替total_fee。即存在total_fee,就不能存在price和quantity;存在price、quantity,就不能存在total_fee。 | 可空 | 10.00 |
quantity | 购买数量 | Number | price、quantity能代替total_fee。即存在total_fee,就不能存在price和quantity;存在price、quantity,就不能存在total_fee。 | 可空 | 1 |
body | 商品描述 | String(1000) | 对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。 | 可空 | 美国专业护腕鼠标垫,舒缓式凝胶软垫模拟手腕的自然曲线和运动,创造和缓的GelFlex舒适地带! |
show_url | 商品展示网址 | String(400) | 收银台页面上,商品展示的超链接。 | 可空 | http://www.360buy.com/product/113714.html |
paymethod | 默认支付方式 | String | 取值范围:
如果不设置,默认识别为余额支付。 说明: 必须注意区分大小写。 | 可空 | directPay |
enable_paymethod | 支付渠道 | String | 用于控制收银台支付渠道显示,该值的取值范围请参见支付渠道。 可支持多种支付渠道显示,以“^”分隔。 | 可空 | directPay^bankPay^cartoon^cash |
anti_phishing_key | 防钓鱼时间戳 | String | 通过时间戳查询接口获取的加密支付宝系统时间戳。 如果已申请开通防钓鱼时间戳验证,则此字段必填。 | 可空 | 587FE3D2858E6B01E30104656E7805E2 |
exter_invoke_ip | 客户端IP | String(15) | 用户在创建交易时,该用户当前所使用机器的IP。 如果商户申请后台开通防钓鱼IP地址检查选项,此字段必填,校验用。 | 可空 | 128.214.222.111 |
extra_common_param | 公用回传参数 | String(100) | 如果用户请求时传递了该参数,则返回给商户时会回传该参数。 | 可空 | 你好,这是测试商户的广告。 |
it_b_pay | 超时时间 | String | 设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。 取值范围:1m~15d。 m-分钟,h-小时,d-天,1c-当天(1c-当天的情况下,无论交易何时创建,都在0点关闭)。 该参数数值不接受小数点,如1.5h,可转换为90m。 | 可空 | 1h |
token | 快捷登录授权令牌 | String(40) | 如果开通了快捷登录产品,则需要填写;如果没有开通,则为空。 | 可空 | 201103290c9f9f2c03db4267a4c8e1bfe3adfd52 |
qr_pay_mode | 扫码支付方式 | String(1) | 扫码支付的方式,支持前置模式和跳转模式。 前置模式是将二维码前置到商户的订单确认页的模式。需要商户在自己的页面中以iframe方式请求支付宝页面。具体分为以下3种:
跳转模式下,用户的扫码界面是由支付宝生成的,不在商户的域名下。
| 可空 | 1 |
qrcode_width | 商户自定二维码宽度 | Integer | 商户自定义的二维码宽度。 当qr_pay_mode=4时,该参数生效。 | 可空 | 200 |
need_buyer_realnamed | 是否需要买家实名认证 | String(2) | 是否需要买家实名认证。
| 可空 | T |
promo_param | 商户优惠活动参数 | String(128) | 商户与支付宝约定的营销透传参数。 | 可空 | {"customer201412":"Y","goods201412":"Y"} |
hb_fq_param | 花呗分期参数 | String | 参数格式:hb_fq_seller_percent ^卖家承担付费比例|hb_fq_num ^期数。
两个参数必须一起传入。 两个参数用“|”间隔。Key和value之间用“^”间隔。 具体花呗分期期数和卖家承担收费比例可传入的数值请咨询支付宝。 | 可空 | hb_fq_seller_percent^100|hb_fq_num^3 |
goods_type | 商品类型 | String(2) | 商品类型:
如果不传,默认为实物类商品。 | 可空 | 1 |
https://mapi.alipay.com/gateway.do?body=%C3%C0%B9%FA%D7%A8%D2%B5%BB%A4%CD%F3%CA%F3%B1%EA%B5%E6%2C%CA%E6%BB%BA%CA%BD%C4%FD%BD%BA%C8%ED%B5%E6%C4%A3%C4%E2%CA%D6%CD%F3%B5%C4%D7%D4%C8%BB%C7%FA%CF%DF%BA%CD%D4%CB%B6%AF%A3%AC%B4%B4%D4%EC%BA%CD%BB%BA%B5%C4GelFlex%CA%E6%CA%CA%B5%D8%B4%F8%21&subject=%B1%B4%B6%FB%BD%F0%BB%A4%CD%F3%CA%BD&sign_type=MD5¬ify_url=http%3A%2F%2Fapi.test.alipay.net&out_trade_no=6741334835157966&return_url=http%3A%2F%2Fapi.test.alipay.net%2Fatinterface%2Freceive_return.htm&sign=dc3d42f405d7e738ab35344449e2d9f7&buyer_id=2088002007018955&total_fee=100&service=create_direct_pay_by_user&partner=2088101568338364&seller_id=2088002007018966&payment_type=1&qr_pay_mode=1&_input_charset=gbk
说明: 本样例仅供参考,支付宝网关为https://mapi.alipay.com/gateway.do。
注意:
- 此接口只支持https请求;
- 参数body(商品描述)、subject(商品名称)、extra_common_param(公用回传参数)不能包含特殊字符(如:#、%、&、+)、敏感词汇,也不能使用外国文字(旺旺不支持的外文,如:韩文、泰语、藏文、蒙古文、阿拉伯语);
- 请按照本文档“附录:签名与验签”中的签名方法对输入参数进行签名,该接口请求才能够被支付宝系统接收;
- 此接口支持重复调用,前提是交易基本信息(买家、卖家、交易金额、超时时间等)在多次调用中保持一致,且交易尚未完成支付;
- 配置qr_pay_mode为0或1或3或4的情况下,同步通知地址return_url需要传入商户中间跳转页面,即该页面需要实现让父页面自行跳转的功能,中间页面javascript代码:<script>window.parent.location.href='父页面调整的URL';</script>