卡卡通WEBSERVICE接口规范-会员管理系统

卡卡通WEBSERVICE接口规范（version2.3）2008-04-29卡卡通WEBSERVICE接口是用于第三方系统或网站与卡卡通平台系统接口时的接口规范，目前支持以SOAP和REST两种接口规范方式。交易类型及代码一览表交易类型输入参数输出参数TRADETYPETRADEMODEPayInFormIntegral储值消费00221交易返回特征码返回消费后储值余额消费撤销00220交易返回特征码返回撤销后储值余额网上储值充值11000交易返回特征码返回充值后储值余额网上充值撤销11001交易返回特征码返回撤销后储值余额网银支付11010交易返回特征码返回充值后储值余额网银支付撤销11011交易返回特征码返回撤销后储值余额终端储值充值11020交易返回特征码返回充值后储值余额终端充值撤销11021交易返回特征码返回撤销后储值余额网银储值充值11030交易返回特征码返回充值后储值余额网银储值撤销11031交易返回特征码返回撤销后储值余额积分累加00330交易返回特征码返回累加后积分值累加撤销00331交易返回特征码返回撤销后积分值积分消费00341交易返回特征码返回积分消费后余额积分消费撤销00340交易返回特征码返回消费撤销后余额储值查询00110交易返回特征码返回储值卡余额积分查询00111交易返回特征码返回积分卡余额交易流水00120交易返回特征码返回交易流水手机/身份证绑定22001交易返回特征码被绑定的号码绑定撤销22000交易返回特征码返回绑定撤销结果修改密码44000交易返回特征码返回修改结果重置密码44001交易返回特征码返回重置结果领卡激活00011交易返回特征码返回激活结果交易流水返回00021交易返回特征码无交易冲正0400-无授权码返回错误值返回值说明0授权码正确1无效授权码2过期授权码3非法授权码4非授权码授权网站接口返回值规范返回值说明00交易失败！01卡号输入错误！02交易金额输入错误！03交易类型校验错误！04交易模式校验错误！05卡号不存在！06原始交易校验失败！07校验失败，密码错误！08卡的可用额度不够！09卡单笔交易额度超出限额10卡有效期已过！11交易成功！12重复交易！13此卡启用时间未到！14此卡已挂失！15此卡已注销！16积分规则不存在！17此卡尚未被激活，请先激活后再交易！18自动冲正成功！19此卡已补办！20积分卡不能进行储值相关操作！21转入卡号与转出卡号不能相同！22请输入转帐交易中的转出卡号！23转入卡启用时间未到！24转入卡已挂失！25转入卡已注销！26转入卡号不支持储值功能！27转入卡号不支持积分功能！28请正确设置次卡的次数和价格！31此卡不支持储值卡功能！32此卡不支持积分卡功能！40绑定成功:被绑定手机/身份证号码：{IDNUM}！41请求绑定的手机/身份证号码错误!42此卡号已和其他手机/身份证绑定!43此卡号在系统中没有与之绑定的手机号码/身份证!44绑定撤销成功！45密码修改成功!46本卡原密码输入不正确!47密码重置成功!50非法版本网关！51网关服务关闭，暂停交易！52请确认所领卡为本发卡商户所申请之卡！53领卡失败，请确认卡号已生成且废卡回收卡不能领卡54发卡商户帐户余额不足，不足以对此卡充值55领卡成功，充值失败56领卡失败！57领卡成功！58终端当天最大充值额已达到！59领卡失败，持卡人手机号码在系统中已存在！60商户被封闭，请联系发卡机构61输入交易流水号不存在！62此交易流水号为已撤销交易流水号！63此交易已经被撤销！64不能撤销不同消费商户所做交易！65消费商户余额不足，不能对此卡充值！66积分卡积分余额不足，不能进行积分消费！67已达到当天最大交易次数！68测试模式下当天交易次数不能超过100！70非网关支持POS机具！71请确认在系统中已申请考勤服务!其他非法操作！加此卡已冻结！注：在同一终端上用同一卡在24小时内做的同一金额交易定义为重复交易，重复交易适用于储值，积分的交易和撤销交易。注：以下接口中的URL/为测试系统webservice接口地址，正式系统URL将在客户系统正式生产后提供。测试系统中的帐户及交易授权码请联系卡卡通客户服务人员获得。储值充值/消费/积分累计/消费/余额查询及撤销接口规范功能最基本的交易接口，如果没有特殊需求的交易均可调用此接口完成。URL/s/sp.php?wsdl(SOAP)/s/get?method=cTRequest&query=query_strying(REST)请求消息：soapCTRequest(SOAP)method=cTRequest(REST)参数参数名含义默认值备注LANG语言GB2312返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY授权码长度为16至512位的系统授权码CARDNO卡号16位标准长度的卡号CARDPWD卡密码6位数字密码经过md5加密后的字符串AMOUNT交易金额交易金额TRADETYPE交易类型参考交易类型及代码一览表TRADEMODE交易模式参考交易类型及代码一览表POSCODE终端ID号卡卡通指定的终端IDITEMCODE服务代码3-8位数字服务代码，由系统管理员在后台系统中设置STANCE_REV将撤销的流水号八位数字只有在交易撤销时才需要提供将被撤销的交易流水号COPNO发卡商户ID号卡卡通制定的发卡商户ID返回值参考接口返回值列表SOAP应答消息：soapCardTradeResponse，如授权码错误则返回数字错误信息，授权码正确返回如下数组REST返回值类型：xml文件，编码方式为UTF-8参数名含义默认值备注PayInForm交易返回特征码两位数字见卡操作返回结果代码部分PayInResult交易返回信息见卡操作返回结果信息部分Stance当前交易流水号八位数字只有交易成功是才返回此特征码Integral交易后储值余额此值为精确到分不带小数点的数字Points交易后积分余额此值为精确到分不带小数点的数字CardNo系统返回卡号空当系统返回卡号不为空时,显示和打印采用此卡号码TradeName服务代码描述ITEMCODE3-20位中文字长度的服务代码描述,系统根据上传的服务代码找到相应的服务代码描述再回传至POS终端示例具体示例

(php)SOAP示范：<?php$trade_code="0011";$trade_mode="0";$cd_no="1680107200000232";//卡号码，须在系统中已存在$cd_pwd="111111";//卡密码$tmn_no="10722001";//操作终端号码$trade_amount="";//交易金额$client=newSoapClient("/s/sp.wsdl", array('location'=>"/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)==2andis_numeric($payInForm)){ if($payInForm=='11'){ echo$res['TradeName'].$res['Integral'];exit; }else{ echo$res['PayInResult'];exit; } }}else{ echo"授权码错误";//返回为数字时为授权码错误}?>REST示范：$base=‘/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($paramsas$key=>$value){$query_string.="$key=".urlencode($value)."&";}$query_string=rtrim($query_string,"&");$url="$base?method=cTRequest&$query_string";$xml=newSimpleXMLElement($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/s/sp.php?wsdl请求消息：soapChangeCardPwdRequest参数参数名含义默认值备注LANG语言GB2312返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY授权码长度最长为512位的系统授权码CARDNO卡号长度为4-16位卡号OLD_PWD旧的卡密码原始密码必须为6位数字NEW_PWD新的卡密码新的密码必须为6数字COPNO发卡商户ID号卡卡通制定的发卡商户IDPOSCODE终端ID号卡卡通指定的终端ID返回值此值直接返回在URL上，可能返回代码：46/47应答消息：soapChangeCardPwdResponse，返回错误代码参数名含义默认值备注PayInForm操作返回特征码两位数字见接口返回值特征码说明CardNo卡号长度为4-16位卡号TradeName交易名交易中文名示例具体示例参考储值消费示例返回结果储值消费示例领卡激活接口规范功能最基本的充值接口，如果没有特殊需求的充值交易均可调用此接口完成。URL/s/sp.php?wsdl请求消息：soapChangeCardPwdRequest参数参数名含义默认值备注LICENSEKEY授权码长度最长为512位的系统授权码CARDNO卡号长度为4-16位卡号CARDPWD卡密码6位数字密码经过加密后的字符串COPNO发卡商户ID号卡卡通制定的发卡商户IDPOSCODE终端ID号卡卡通指定的终端ID返回值此值直接返回在URL上参数名含义默认值备注Result交易返回特征码两位数字见接口返回值特征码说明CardNo卡号16位示例具体示例参考储值消费示例返回结果储值消费示例交易流水接口规范功能查询各种流水。只能用终端号，卡号，交易流水号中的一个来条件来查询，这3个参数都为0时按商户号来查询时间为可选项，不需要时设置为0URL参数参数名含义默认值备注LANG语言GB2312返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY授权码长度最长为512位的系统授权码CARDNO卡号卡号，不按卡号查询时设置为0CARDPWD卡密码6位数字密码经过加密后的字符串TRADETYPE交易类型0012此值固定不变，不得更改，否则交易不成功TRADEMODE交易模式0此值固定不变，不得更改，否则交易不成功POSCODE终端ID号不按终端号查询时设置为0COPNO商户号商户号，必填项，用于验证交易授权码START交易开始时间交易开始时间，不按时间查询时设置为0END交易结束时间交易结束时间，不按时间查询时设置为0STANCE_NO交易流水号交易流水号，不按流水号查询时设置为0返回值此值直接返回在URL上参数名含义默认值备注Stance当前交易流水号六位数字只有交易成功是才返回此特征码CardNo卡号卡号，不按卡号查询时设置为0AMOUNT交易金额交易金额Points交易后积分余额此值为精确到分不带小数点的数字TradeTime交易发生时间交易发生时间Integral充值后储值余额充值后储值余额TradeName交易名交易中文名示例具体示例参考储值消费示例返回结果储值消费示例修改/查询个人信息接口规范功能修改，查询持卡人个人信息URL/s/get?method=cIRequest参数参数名含义默认值备注LANG语言GB2312返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY授权码长度最长为512位的系统授权码CARDNO卡号卡号，不按卡号查询时设置为0COPNO商户号商户号，必填项，用于验证交易授权码USR_CH_NAME中文名持卡人中文名USR_EN_NAME英文名持卡人英文名USR_ADDR地址持卡人地址USR_EMAIL邮件持卡人邮件USR_MOBILE_NO手机持卡人手机USR_TEL_PHONE电话持卡人电话USR_BIRTHDAY生日持卡人生日返回值此值直接返回在URL上参数名含义默认值备注CARDNO卡号卡号，不按卡号查询时设置为0COPNO商户号商户号，必填项，用于验证交易授权码USR_CH_NAME中文名持卡人中文名USR_EN_NAME英文名持卡人英文名USR_ADDR地址持卡人地址USR_EMAIL邮件持卡人邮件USR_MOBILE_NO手机持卡人手机USR_TEL_PHONE电话持卡人电话USR_BIRTHDAY生日持卡人生日示例具体示例参考储值消费示例返回结果储值消费示例身份证或手机号码绑定/绑定撤销接口规范功能绑定/绑定撤销身份证或手机号码URL/s/get?method=bCRequest参数参数名含义默认值备注LANG语言GB2312返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY授权码长度最长为512位的系统授权码CARDNO卡号卡号，不按卡号查询时设置为0COPNO商户号商户号，必填项，用于验证交易授权码CARDPWD卡密码卡密码IDNUM绑定号身份证或手机号码TRADEMODE模式1为绑定0为绑定撤销POSCODE终端号返回值此值直接返回在URL上参数名含义默认值备注Result交易返回特征码两位数字见接口返回值特征码说明CARDNO卡号卡号，不按卡号查询时设置为0COPNO商户号商户号，必填项，用于验证交易授权码IDNum绑定号身份证或手机号码TmnNo终端号示例具体示例参考储值消费示例返回结果储值消费示例测试实例：卡号：1680115500000126~1680115500000133商户号：1155终端号：11552001授权码：NV41VDlSNldhFTFeYw0z领卡激活提交/s/get?method=aCRequest&LICENSEKEY=NV41VDlSNldhFTFeYw0z&COPNO=1155&POSCODE=11552001&CARDNO=1680115500000125&CARDPWD=111111返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><Result>11</Result><CardNo>1680115500000125</CardNo></Record></TradeResult>交易(储值充值)提交/s/get?method=cTRequest&LANG=GB2312&LICENSEKEY=NV41VDlSNldhFTFeYw0z&TRADETYPE=1102&TRADEMODE=0&CARDNO=1680115500000125&CARDPWD=96e79218965eb72c92a549dd5a330112&POSCODE=11552001&AMOUNT=200&ITEMCODE=&STANCE_REV=&COPNO=1155&STANCE_REV=要撤销的交易流水号，撤销交易时用返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><PayInForm>11</PayInForm><PayInResult>(11)交易成功！</PayInResult><Stance>00006698</Stance><Integral>200</Integral><Points/><CardNo>1680115500000125</CardNo><TradeName>储值充值</TradeName></Record></TradeResult>重置卡密码提交/s/get?method=rSCardPwd&LANG=GB2312&LICENSEKEY=NV41VDlSNldhFTFeYw0z&CARDNO=1680115500000125&NEW_PWD=111111&POSCODE=11552001&OLD_PWD=&COPNO=1155返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><PayInForm>11</PayInForm><CardNo>1680115500000125</CardNo><TradeName>修改/重置密码</TradeName></Record></TradeResult>获得交易流水提交/s/get?method=tSRequest&LANG=GB2312&LICENSEKEY=NV41VDlSNldhFTFeYw0z&TRADETYPE=0012&TRADEMODE=0&POSCODE=0&CARDNO=&START=2007-01-14+00%3A14%3A48&END=2008-01-15+15%3A14%3A48&COPNO=1155&STANCE_NO=00000010部分参数说明：&LANG=GB2312返回语言种类&LICENSEKEY=Zg04WTBbNldjFzVaZAoy交易授权码&TRADETYPE=0012固定值&TRADEMODE=0固定值&POSCODE=0终端号，不按终端号查询时设置为0&CARDNO=00000010卡号，不按卡号查询时设置为0&START=2007-01-14+00%3A14%3A48交易开始时间，不按时间查询时设置为0&END=2008-01-15+15%3A14%3A48交易结束时间，不按时间查询时设置为0&COPNO=1104商户号，必填项，用于验证交易授权码&STANCE_NO=00000010交易流水号，不按流水号查询时设置为0只能用终端号，卡号，交易流水号中的一个来条件来查询，这3个参数都为0时按商户号来查询时间为可选项，不需要时设置为0返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><stanceNo>00000053</stanceNo><CardNo>1680010500000006</CardNo><Amount>11000.00</Amount><Points>0.00</Points><TradeTime>2007-06-0113:27:37</TradeTime><TmnNo>10051001</TmnNo><TradeName>充值撤销</TradeName></Record>-<Record><stanceNo>00000052</stanceNo><CardNo>1680010500000006</CardNo><Amount>11000.00</Amount><Points>0.00</Points><TradeTime>2007-06-0113:19:45</TradeTime><TmnNo>10051001</TmnNo><TradeName>储值消费</TradeName></Record>…省略…修改或查询用户信息查询提交/s/get?method=cIRequest&LANG=GB2312&LICENSEKEY=NV41VDlSNldhFTFeYw0z&CARDNO=1680115500000125&COPNO=1155&USR_CH_NAME=&USR_EN_NAME=&USR_ADDR=&USR_EMAIL=&USR_MOBILE_NO=&USR_TEL_PHONE=&USR_BIRTHDAY=返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><Result/><CardNo>1680115500000125</CardNo><CopNo>1155</CopNo><UsrChName/><UsrEnName/><UsrAddr/><UsrEmail/><UsrMobile/><UsrTel/><UsrBirthday>0000-00-00</UsrBirthday></Record></TradeResult>修改提交/s/get?method=cIRequest&LANG=GB2312&LICENSEKEY=NV41VDlSNldhFTFeYw0z&CARDNO=1680115500000125&COPNO=1155&USR_CH_NAME=&USR_EN_NAME=ceraki&USR_ADDR=&USR_EMAIL=czx@&USR_MOBILE_NOUSR_TEL_PHONE=&USR_BIRTHDAY=返回<?xmlversion="1.0"encoding="UTF-8"?>-<TradeResult>-<Record><Result/><CardN