ecshop整合特价王CPS订单跟踪接口

     ecshop整合特价王CPS订单跟踪接口

特价王CPS订单跟踪接口(V1.4.0)
商家网站接入说明

1. 概述流程
订单跟踪接口实现对通过特价王去合作商家产生订单后自动将订单相关信息传回特价王。

2. 接入步骤
2.1. 请求说明
用户通过特价王发送请求到商家服务器，在URL中包含来源特价王、用户标识和目标访问地址
例如：
http://www.yourhost.com/jump.aspx?source=tejiawang&uid=19659&url=http://www.yourhost.com
jump.aspx 接收程序，用于接收来源、用户标识、并执行跳转（命名和程序类型根据自身网站程序来决定）
source    表示来源于特价王网站
uid       用户标识，特价王下线ID
url       商家网站目标URL

2.2. 记录相关信息
商家接收到特价王请求，通过用户Session或Cookie记录来源和用户标识，在订单提交时传回特价王服务器。（只用通过GET方式获取）
方案事例：
新建一个接收程序，来记录来源和用户标识，同时响应URL请求，到达指定页面。

2.3. 发送订单信息
当用户在商家网站下单的时候，在订单生成页检测是否有特价王来源和用户标识，如果有则调用特价王订单接口程序，将订单信息传递到特价王服务器。
调用格式如下：
接口地址：http://www.tejiawang.com/trace/orderadd.aspx
接收Get方式发送，发送内容如下：
参数名称 值类型 描述说明
pID [int] 商家标识，由特价王提供，请见文档顶部。（必须）
pName [string] 商家名称，商家的名字简称，由特价王提供，请见文档顶部。（必须）
uID [int] 特价王用户标识，在将用户引导到商家页面时传送给商家。（必须）
oCode [string] 订单号，用户在商家网站下单的订单号。（必须）
oTime [date(yyyy-mm-dd hh:mm:ss)] 下单时间，用户在商家网站订单生成时间。（必须）
oNum [int] 购买数量，用户订单中的商品订购数量。（必须，可以为1）
oPrice [float x.xx] 商品单价，用户在订单中的商品单价。（该参数为特殊参数，一般情况下传oTotal一样的值）（必须，建议跟oTatal相同）
oTotal [float x.xx] 订单金额，用户订单的总金额。（必须）
oMBack [float x.xx] 回馈金额，该订单回馈的总金额。
根据与特价王的合同协议，将相应的CPS佣金计算出来返回给特价王。（必须）
vCode [string] 验证字符串，用 pID + oCode 后取得32位md5 校验码。
例如Pid为289 oCode为56，则vCode为28956的
32位MD5码(115acf0e62e6e62aab5e6dcd475d1a32),用户可以用这个来验证自己的MD5加密是否正确。（必须）

ecshop订单接口示范代码：
<script src="http://www.tejiawang.com/trace/orderadd.aspx?pid=1&pname=2&uID=19659&ocode=3&otime=2008-08-08%2011:58:04&onum=5&oprice=6&ototal=7&omback=8&vcode=C51CE410C124A10E0DB5E4B97FC2AF39"></script>
可以在订单生成页面嵌入以上JS，用户提交订单的时候执行，将订单信息传递到特价王服务器。

3. 接口返回值
0:　 正常，订单信息正常接受到
1:   数据类型错误．
2:   md5验证失败
3:   数据库写入失败
4:   数据已存在

返回值主要是方便在做接口程序的时候，测试是否能够正确的将订单信息发送到特价王服务器。
示范例子：
通过浏览器来访问下单时生成的URL
http://www.tejiawang.com/trace/orderadd.aspx?pid=1&pname=2&uID=19659&ocode=3&otime=2008-08-08%2011:58:04&onum=5&oprice=6&ototal=7&omback=8&vcode=C51CE410C124A10E0DB5E4B97FC2AF39
该程序会返回相应值，来检测订单接口是否正常。
做接口要5个参数，source ,uid ,url ,pid,pname,还有合同中的返点比例都要加到做好的订单接口连接上的
 

来源：http://www.chinab4c.com