原文:.Net在线付款---Paydollar在线付款开发过程
最近在做一个Web订单项目,项目有一个需求就是集成Paypal与Paydollar在线付款,一开始看到这个需求也是傻了眼,因为以前从来没有做过在线付款的功能,于是打开百度,google 狂搜一通,发现.net下的paydollar付款開發介绍很不全面,没有找到我心中想要的答案,没有办法,只要老老实实的跟着网站上提供的文文件来做,在项目快完成时,于是想将现在做的一些心得和步骤记录下来,以备以后有用!
你可以进入http://www.paydollar.com/ 了解Paydollar的更多内容.
你在做asp.net集成Paydollar在线付款需要以下的条件:
1. 需要有.net开发基础(废话).
2. 需要有一个在外网可以访问到的网址.
3. 需要仔细阅读PayDollar集成文檔,以备参考.
4. 需要注册Paydollar的正式账号与测试账号(本文以测试账号为例).
假定我们现在的系统叫Order系统,需要集成在线付款,本文按照如下的流程来讲述PayDollar的开发过程:
1. 获得Paydollar的测试账号.
2. 编写一个HTML Form 将订单的一些相关信息POST到Paydollar的页面上去.
3. 提供一个页面用于让Paydollar更新我们的Order系统.
4. 返回到Order系统的提示页面.
一 获得Paydollar的测试账号
Paydollar为我们提供一个可以测试的虚拟付款的付款网站:
https://test.paydollar.com/b2cDemo/eng/merchant/index.html
界面上要求你用merchantID,loginName,Password来登录,据我所知Paydollar是没有提供注册测试账号的页面(如果哪一个高手知道Paydollar提供了注册測試的账号頁面,请你提醒我,谢谢),你可以向Paydollar的客服询问注册的事项, 我相信Paydollar的客服人员一定会执情的给你帮助,你相信Paydollar客服人员会热情的给你帮助吗?反正我信了!我的测试账号也是由公司和Paydollar联系我才获得的.
二. 编写一个HTML Form 将订单的一些相关信息POST到Paydollar的页面上去.
2
3 <input type='hidden' name='merchantId' value='XXXXXXXX'/>
4
5 <input type='hidden' name='amount' value='450.00' />
6
7 <input type='hidden' name='orderRef' value='OP0000049'/>
8
9 <input type='hidden' name='currCode' value='344'/>
10
11 <input type='hidden' name='mpsMode' value='NIL'/>
12
13 <input type='hidden' name='successUrl' value='http://test.yourdomain.com/hk/onlineorder/payResult.aspx?result=success'/>
14
15 <input type='hidden' name='failUrl' value='http://test. yourdomain.com/hk/onlineorder/payResult.aspx?result=fail'/>
16
17 <input type='hidden' name='cancelUrl' value='http://test.yourdomain.com/hk/onlineorder/payResult.aspx?result=cancel'/>
18
19 <input type='hidden' name='payType' value='N'/>
20
21 <input type='hidden' name='lang' value='C'/>
22
23 <input type='hidden' name='payMethod' value='CC'/>
24
25 </form>
学习过HTML的同学都会知道上面是什么意思,以下是我对上面的一些参数含义的解释,如果你需要更多的帮助,你可以阅读PayDollar集成指南的相关章节:
1. 请将form的method设置成POST 将action设置成https://test.paydollar.com/b2cDemo/eng/payment/payForm.jsp,
如果要变成正式付款请将它设置成:
https://www.paydollar.com/b2c2/eng/payment/payForm.jsp
2. merchantId设置成Paydollar提供给你的账号,如果是正式环境发布,就需要用正式的账号
3. amout设置成你要付款的金额
4. orderref设置成你要付款的订单号
5. successUrl:设置成付款成功后跳转到Order系统的网页地址
6. failUrl:设置成付款失败后跳转到Order系统的网页地址
7. cancelUrl:设置成取消付款后跳转到Order系统的网页地址
8. payMethod设置你的付款方式,CC为信用卡付款
(如果你要更详细的参数设置介绍,你可以查看Paydollar集成文档的第十二页[集成页中参数的定义])
在这里我并不贴出Order系统的其它的代码,我们只要将这个Form的代码生成好,动态替换里面要改变的参数(比如amout,orderref等)提交上去就好了,就比如说,一个页面上可以放两个Form,一个Form用于显示购物车里面的信息,另一个Form就可以放以上的代码,只要保证第二个Form提交了就OK了,悄悄的告诉你,我就是用StringBuilder这样一条一条append上去的,遇到要替换的参数我就Replace一下,我相信你一定知道我是怎么做的,哈哈,你信不信不要紧,反正我相信了!
当你将该Form提交后,你可以看到Order系统已跳转到test.paydollar的测试付款页面了
选择Visa或者是MasterCard
然后在页面上输入获取Paydollar账号时Paydollar提供给你的测试卡号信息
当你点击提交按钮时,Paydollar就会开始给你做付款操作了.
三 提供一个页面(PaydollarDataFeed.aspx)用于让Paydollar更新我们的Order系统
当Paydollar在做付款操作时,paydollar会将本次付款的信息(如交易号,付款状态等)Post回Order系统,以便Order系统更新自己的系统,比如说更新订单的交易号与交易日期, 所以我们要提供一个页面来接收这一些数据,这个页面在Paydollar里面叫DataFeed页面,(这个页面我们取名为PayDollarDataFeed.aspx)如果你想了解更多DataFeed的知识,请阅读Paydollar的集成文檔第35页
DataFeed页面是需要设置的,具体设置如下:
PayDollar管理页面的接收地址更改
进入管理页面后,选择ProfileàPayment Options
将进入如下页面
将Return value Link(DataFeed)改成你外网上可以接收的地址
可以点击test按钮查看可否接收DataFeed
如果Result为Success表示该页面可以用来接收DataFeed
根据PayDollar集成文檔上的提示:
返回链接页面必须符合下面要求:
- 当数据的预授权完成时,在HTML中打印“OK”(ACK信息)
- 一定先打印“OK”对我方系统进行确认,然后,再进行贵方其它的系统处理, 如果系统处理出错(即下载照片、手机铃声), 可向我方系统发送一个撤销请求,详细内容请参考P.42或联系我们的技术人员。
请注意:对于返回链接页面的网址,系统只支持端口80 (HTTP)或443(HTTPS)。并确保从外部可进入返回链接页面的网址,这样我们的服务器才能调用返回链接页面。
*因为系统从返回链接页面读取“OK”两字来测定是否(返回链接)信息已被交付,如果这两个字没有成功返回,系统将假定返回链接已丢失。
我的PayDollarDataFeed.aspx的后台代码如下:
1 OrderService service=new OrderService(); 2 3 private void Page_Load(object sender, System.EventArgs e) 4 5 { 6 7 Response.Write("OK"); 8 9 string successCode=Request.Form["successcode"].ToString();10 11 string payRef=Request.Form["PayRef"].ToString();12 13 string orderID=Request.Form["Ref"].ToString();14 15 //Request.Form的取值,可以阅读payDollar集成文檔16 17 if(!Page.IsPostBack)18 19 {20 21 if(successCode=="0")22 23 {24 25 service.SetOrderIsPay(payRef,orderID);//更新Order系统26 27 }28 29 }30 31 }
个人体会:
1.我个人认为,payDollar要求我们提供的DataFeed页面只能用于更新Order系统,不应该用于显示界面(包括付款结果),一开始我错误的将上一步Form里面设置的successUrl,failUrl,cancelUrl和DataFeed页面混在一起,错误的以为DataFeed和这一些URL可以放在同一个页面,更新完自己的系统就可以将付款结果显示出来,结果老是取不到PayDollar返回回来的参数.
2.Order系统提供的DataFeed页面,是一定要有外网上可以访问的,要不然会造成返回参数接收不成功!我曾经在这个地方卡住很久,后来换成外网地址后就可以接收返回参数.
四 返回到Order系统的提示页面
当paydollar付款成功后,点击按钮,Paydollar就会返回回Order系统,
如果是付款成功就会跳转到Form里设置的successUrl的网址上.
如果是付款失败就会跳转到Form里设置的failUrl的网址上.
如果是取消付款就会跳转到Form里设置的cancelUrl的网址上.
当系统开发完成后,你的公司可能会向Paydollar申请正式的账号,这时你需要将Form的一些测试信息更改成正式信息(比如说action地址,merchantID等).