卡卡通WEB SERVICE接口规范
注：以下接口中的URL http://beta.kakatong.com/为测试系统webservice接口地址，正式系统URL将在客户系统正式生产后提供。测试系统中的帐户及交易授权码请联系卡卡通客户服务人员获得。
| 储值充值/消费/积分累计/消费/余额查询及撤销接口规范 | ||||
| 功能 | 最基本的交易接口，如果没有特殊需求的交易均可调用此接口完成。 | |||
| URL | http://beta.kakatong.com/s/sp.php?wsdl (SOAP)http://beta.kakatong.com/s/get?method=cTRequest&query=query_strying (REST) | |||
| 请求消息：soapCTRequest(SOAP) method=cTRequest (REST) | ||||
| 参数 | 参数名 | 含义 | 默认值 | 备注 |
| LANG | 语言 | GB2312 | 返回信息的语言及代码，默认为英文，简体中文为GB2312 | |
| LICENSEKEY | 授权码 | 长度为16至512位的系统授权码 | ||
| CARDNO | 卡号 | 16位标准长度的卡号 | ||
| AMOUNT | 交易金额 | 此值传递前必须*100处理。然后传递，否则交易不正确 | ||
| TRADETYPE | 交易类型 | 参考交易类型及代码一览表 | ||
| TRADEMODE | 交易模式 | 参考交易类型及代码一览表 | ||
| POSCODE | 终端ID号 | 卡卡通指定的终端ID | ||
| ITEMCODE | 服务代码 | 3-8位数字服务代码，由系统管理员在后台系统中设置 | ||
| STANCE_REV | 将撤销的流水号 | 八位数字 | 只有在交易撤销时才需要提供将被撤销的交易流水号 | |
| COPNO | 发卡商户ID号 | 卡卡通制定的发卡商户ID | ||
| 返回值 | 参考接口返回值列表 | |||
| SOAP应答消息： soapCardTradeResponse，如授权码错误则返回数字错误信息，授权码正确返回如下数组REST返回值类型：xml文件，编码方式为UTF-8 | ||||
| 参数名 | 含义 | 默认值 | 备注 | |
| PayInForm | 交易返回特征码 | 两位数字 | 见卡操作返回结果代码部分 | |
| PayInResult | 交易返回信息 | 见卡操作返回结果信息部分 | ||
| Stance！ | 当前交易流水号 | 八位数字 | 只有交易成功是才返回此特征码 | |
| RandNum | 随机六位授权号 | 六位数字 | 只有交易成功是才返回此特征码 | |
| Integral | 交易后储值余额 | 此值为精确到分不带小数点的数字 | ||
| Points | 交易后积分余额 | 此值为精确到分不带小数点的数字 | ||
| CardNo | 系统返回卡号 | 空 | 当系统返回卡号不为空时,显示和打印采用此卡号码 | |
| SERVDESC | 服务代码描述 | ITEMCODE | 3-20位中文字长度的服务代码描述,系统根据上传的服务代码找到相应的服务代码描述再回传至POS终端 | |
| 示例 | 具体示例(php) | SOAP示范： <?php $trade_code="0011"; $trade_mode="0"; $cd_no="1680107200000232"; //卡号码，须在系统中已存在 $cd_pwd="111111"; //卡密码 $tmn_no="10722001"; //操作终端号码 $trade_amount=""; //交易金额 $client = new SoapClient("http://beta.kakatong.com/s/sp.wsdl", array('location' => "http://beta.kakatong.com/s/sp.php", 'encoding'=>'GB2312', 'soap_version' => SOAP_1_2, 'trace' => 1 ) ); $lickey=" M1g0VTFaNldhFTdYNVtm"; $res = $client->soapCardTrade($lickey,$trade_code,$trade_mode,$cd_no,$cd_pwd,$tmn_no, $trad_amount,$item_code,$stance_rev);//返回变量详细参数请参考卡卡通SOAP网关接口规范 if (is_array($res)) {//交易成功返回数组变量 $payInForm = $res['PayInForm']; if (strlen($payInForm)== 2 and is_numeric($payInForm)){ if ($payInForm == '11') { echo $res['TradeName']. $res['Integral'];exit; } else { echo $res['PayInResult'];exit; } } } else { echo "授权码错误";//返回为数字时为授权码错误}?>REST示范： $base = ‘http://beta.kakatong.com/s/get’, $query_string = ''; $passwd = md5('xxxxxx'); $params = array( 'LANG' => "GB2312", 'LICENSEKEY' => ' ZgpjDGQHYgNjDzRcZgk1RjBxE4CWRCYVM4HjgJZVdlSQ.', 'TRADETYPE' => '0022', 'TRADEMODE' => '1', 'CARDNO' => '1680107200000232', 'CARDPWD' => $passwd, 'POSCODE' => '10722001', 'AMOUNT' => '100', 'ITEMCODE' => '123',); foreach ($params as $key => $value) { $query_string .= "$key=" . urlencode($value) . "&"; } $query_string = rtrim($query_string, "&"); $url = "$base?method=cTRequest&$query_string"; $xml = new SimpleXMLElement($url,NULL,TRUE); echo $xml->PayInResult; //返回操作结果信息 echo $xml->Integral; //返回交易后的储值余额 SOAP:储值查询 200.00REST:XML:<TradeResult> <PayInForm>11</PayInForm> <PayInResult>交易成功！</PayInResult> <Stance>00000860</Stance> <Integral>100</Integral><Points/> <CardNo>1680107200000232</CardNo> <TradeName>积分查询</TradeName> </TradeResult> |
||
| 功能 | 最基本的交易接口，如果没有特殊需求的交易均可调用此接口完成。 | ||
| URL | http://beta.kakatong.com/s/sp.php?wsdl (SOAP)http://beta.kakatong.com/s/get?method=cTRequest&query=query_strying (REST) | ||
| 请求消息：method=tSRequest(REST) | |||
| 参数 | 参数名 | 含义 | 默认值 |
| LANG | 语言 | GB2312 | |
| LICENSEKEY | 授权码 | ||
| TRADETYPE | 交易类型 | 0012 | |
| TRADEMODE | 交易模式 | 0 | |
| POSCODE | 终端ID号 | ||
| CARDNO | 卡号 | ||
| START | 流水开始时间 | 0 | |
| END | 流水结束时间 | 0 | |
| COPNO | 发卡商户ID号 | ||
| STANCE_NO | 服务代码 | ||
| 返回值 | REST返回值类型：xml文件，编码方式为UTF-8 | ||
| 参数名 | 含义 | 默认值 | |
| stanceNo | 交易流水号 | 八位数字 | |
| CardNo | 当前交易流水号 | 十六位数字 | |
| Amount | 交易金额 | ||
| Points | 交易积分 | 0 | |
| TradeTime | 交易完成时间 | ||
| TmnNo | 产生交易的终端 | ||
| TradeName | 交易名称 | ||
| SERVDESC | 服务代码描述 | ||
| 示例 | 具体示例 | 参考储值消费示例http://beta.kakatong.com/s/get?method=tSRequest&LANG=GB2312&LICENSEKEY=Zg04WTBbNldj | |
| 返回结果 | 储值消费示例 | ||
