卡卡通WEB SERVICE接口规范.doc

1、卡卡通 WEB SERVICE 接口规范（version 2.3）2008-04-29卡卡通 WEB SERVICE 接口是用于第三方系统或网站与卡卡通平台系统接口时的接口规范，目前支持以 SOAP 和REST 两种接口规范方式。交易类型及代码一览表输入参数 输出参数交易类型TRADETYPE TRADEMODE PayInForm Integral储值消费 0022 1 交易返回特征码 返回消费后储值余额消费撤销 0022 0 交易返回特征码 返回撤销后储值余额网上储值充值 1100 0 交易返回特征码 返回充值后储值余额网上充值撤销 1100 1 交易返回特征码 返回撤销后储值余额网银支付

2、 1101 0 交易返回特征码 返回充值后储值余额网银支付撤销 1101 1 交易返回特征码 返回撤销后储值余额终端储值充值 1102 0 交易返回特征码 返回充值后储值余额终端充值撤销 1102 1 交易返回特征码 返回撤销后储值余额网银储值充值 1103 0 交易返回特征码 返回充值后储值余额网银储值撤销 1103 1 交易返回特征码 返回撤销后储值余额积分累加 0033 0 交易返回特征码 返回累加后积分值累加撤销 0033 1 交易返回特征码 返回撤销后积分值积分消费 0034 1 交易返回特征码 返回积分消费后余额积分消费撤销 0034 0 交易返回特征码 返回消费撤销后余额储值查询

3、 0011 0 交易返回特征码 返回储值卡余额积分查询 0011 1 交易返回特征码 返回积分卡余额交易流水 0012 0 交易返回特征码 返回交易流水手机/身份证绑定 2200 1 交易返回特征码 被绑定的号码绑定撤销 2200 0 交易返回特征码 返回绑定撤销结果修改密码 4400 0 交易返回特征码 返回修改结果重置密码 4400 1 交易返回特征码 返回重置结果领卡激活 0001 1 交易返回特征码 返回激活结果交易流水返回 0002 1 交易返回特征码 无交易冲正 0400 - 无授权码返回错误值返回值 说明0 授权码正确1 无效授权码2 过期授权码3 非法授权码4 非授权码授权网站

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

5、 转入卡已挂失！25 转入卡已注销！26 转入卡号不支持储值功能！27 转入卡号不支持积分功能！28 请正确设置次卡的次数和价格！31 此卡不支持储值卡功能！加此卡已冻结！注：在同一终端上用同一卡在 24 小时内做的同一金额交易定义为重复交易，重复交易适用于储值，积分的交易和撤销交易。32 此卡不支持积分卡功能！40 绑定成功:被绑定手机/身份证号码： IDNUM！41 请求绑定的手机/身份证号码错误!42 此卡号已和其他手机/身份证绑定!43 此卡号在系统中没有与之绑定的手机号码/身份证!44 绑定撤销成功！45 密码修改成功!46 本卡原密码输入不正确!47 密码重置成功!50 非法版本网

6、关！51 网关服务关闭，暂停交易！52 请确认所领卡为本发卡商户所申请之卡！53 领卡失败，请确认卡号已生成且废卡回收卡不能领卡54 发卡商户帐户余额不足，不足以对此卡充值55 领卡成功，充值失败56 领卡失败！57 领卡成功！58 终端当天最大充值额已达到！59 领卡失败，持卡人手机号码在系统中已存在！60 商户被封闭，请联系发卡机构61 输入交易流水号不存在！62 此交易流水号为已撤销交易流水号！63 此交易已经被撤销！64 不能撤销不同消费商户所做交易！65 消费商户余额不足，不能对此卡充值！66 积分卡积分余额不足，不能进行积分消费！67 已达到当天最大交易次数！68 测试模式下当天交

7、易次数不能超过 100！70 非网关支持 POS 机具！71 请确认在系统中已申请考勤服务!其他 非法操作！注：以下接口中的 URL http:/ webservice 接口地址，正式系统 URL 将在客户系统正式生产后提供。测试系统中的帐户及交易授权码请联系卡卡通客户服务人员获得。储值充值/ 消费/积分累计/消费/余额查询及撤销接口规范功能最基本的交易接口，如果没有特殊需求的交易均可调用此接口完成。http:/ (SOAP)http:/ M1g0VTFaNldhFTdYNVtm“;$res = $client-soapCardTrade($lickey,$trade_code,$trade_

8、mode,$cd_no,$cd_pwd,$tmn_no, $trad_amount,$item_code,$stance_rev);/返回变量详细参数请参考卡卡通 SOAP 网关接口规范if (is_array($res) /交易成功返回数组变量$payInForm = $resPayInForm;if (strlen($payInForm)= 2 and is_numeric($payInForm)if ($payInForm = 11) echo $resTradeName.$resIntegral;exit; else echo $resPayInResult;exit; else ec

9、ho “授权码错误 “;/返回为数字时为授权码错误?REST 示范：$base = http:/ = ;$passwd = md5(xxxxxx);$params = array( LANG = “GB2312“,LICENSEKEY = ZgpjDGQHYgNjDzRcZgk1RjBxE4CWRCYVM4HjgJZVdlSQ.,TRADETYPE = 0022,TRADEMODE = 1,CARDNO = 1680107200000232,CARDPWD = $passwd,POSCODE = 10722001,AMOUNT = 100,ITEMCODE = 123,);foreach ($

10、params as $key = $value) $query_string .= “$key=“ . urlencode($value) . “$query_string = rtrim($query_string, “$url = “$base?method=cTRequest$xml = new SimpleXMLElement($url,NULL,TRUE);echo $xml-PayInResult; /返回操作结果信息领卡激活接口规范功能 最基本的充值接口，如果没有特殊需求的充值交易均可调用此接口完成。http:/ 参数名 含义 默认值 备注echo $xml-Integral;

11、/返回交易后的储值余额返回结果 SOAP:储值查询 200.00REST:XML:11交易成功！000008601001680107200000232积分查询 卡密码重置接口规范功能 最基本的充值接口，如果没有特殊需求的充值交易均可调用此接口完成。http:/ 含义 默认值 备注LANG 语言 GB2312 返回信息的语言及代码，默认为英文，简体中文为GB2312LICENSEKEY 授权码 长度最长为 512 位的系统授权码CARDNO 卡号 长度为 4-16 位卡号OLD_PWD 旧的卡密码 原始密码必须为 6 位数字NEW_PWD 新的卡密码 新的密码必须为 6 数字COPNO 发卡商户

12、 ID 号 卡卡通制定的发卡商户 ID参数POSCODE 终端 ID 号 卡卡通指定的终端 ID此值直接返回在 URL 上，可能返回代码： 46/47应答消息： soapChangeCardPwdResponse，返回错误代码参数名 含义 默认值 备注PayInForm 操作返回特征码 两位数字 见接口返回值特征码说明CardNo 卡号 长度为 4-16 位卡号返回值TradeName 交易名 交易中文名具体示例 参考储值消费示例示例返回结果 储值消费示例LICENSEKEY 授权码 长度最长为 512 位的系统授权码CARDNO 卡号 长度为 4-16 位卡号CARDPWD 卡密码 6 位数

13、字密码经过加密后的字符串COPNO 发卡商户 ID 号 卡卡通制定的发卡商户 IDPOSCODE 终端 ID 号 卡卡通指定的终端 ID此值直接返回在 URL 上参数名 含义 默认值 备注Result 交易返回特征码 两位数字 见接口返回值特征码说明返回值CardNo 卡号 16 位具体示例 参考储值消费示例示例返回结果 储值消费示例交易流水接口规范功能 查询各种流水。只能用 终端号，卡号，交易流水号中的一个来条件来查询，这 3 个参数都为 0 时按商户号来查询时间为可选项，不需要时设置为 0URL参数名 含义 默认值 备注LANG 语言 GB2312 返回信息的语言及代码，默认为英文，简体中

14、文为GB2312LICENSEKEY 授权码 长度最长为 512 位的系统授权码CARDNO 卡号 卡号，不按卡号查询时设置为 0CARDPWD 卡密码 6 位数字密码经过加密后的字符串TRADETYPE 交易类型 0012 此值固定不变，不得更改，否则交易不成功TRADEMODE 交易模式 0 此值固定不变，不得更改，否则交易不成功POSCODE 终端 ID 号 不按终端号查询时设置为 0COPNO 商户号 商户号，必填项，用于验证交易授权码START 交易开始时间 交易开始时间，不按时间查询时设置为 0END 交易结束时间 交易结束时间，不按时间查询时设置为 0参数STANCE_NO 交易

15、流水号 交易流水号，不按流水号查询时设置为 0此值直接返回在 URL 上参数名 含义 默认值 备注Stance 当前交易流水号 六位数字 只有交易成功是才返回此特征码CardNo 卡号 卡号，不按卡号查询时设置为 0AMOUNT 交易金额 交易金额Points 交易后积分余额 此值为精确到分不带小数点的数字TradeTime 交易发生时间 交易发生时间Integral 充值后储值余额 充值后储值余额返回值TradeName 交易名 交易中文名具体示例 参考储值消费示例示例返回结果 储值消费示例修改/ 查询个人信息接口规范功能 修改，查询持卡人个人信息http:/ 含义 默认值 备注LANG 语

16、言 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

17、卡号 卡号，不按卡号查询时设置为 0COPNO 商户号 商户号，必填项，用于验证交易授权码USR_CH_NAME 中文名 持卡人中文名USR_EN_NAME 英文名 持卡人英文名USR_ADDR 地址 持卡人地址USR_EMAIL 邮件 持卡人邮件USR_MOBILE_NO 手机 持卡人手机USR_TEL_PHONE 电话 持卡人电话返回值USR_BIRTHDAY 生日 持卡人生日具体示例 参考储值消费示例示例返回结果 储值消费示例身份证或手机号码绑定/绑定撤销接口规范功能 绑定/绑定撤销身份证或手机号码http:/ 含义 默认值 备注LANG 语言 GB2312 返回信息的语言及代码，默认为

18、英文，简体中文为GB2312LICENSEKEY 授权码 长度最长为 512 位的系统授权码CARDNO 卡号 卡号，不按卡号查询时设置为 0COPNO 商户号 商户号，必填项，用于验证交易授权码参数CARDPWD 卡密码 卡密码IDNUM 绑定号 身份证或手机号码TRADEMODE 模式 1 为绑定 0 为绑定撤销POSCODE 终端号此值直接返回在 URL 上参数名 含义 默认值 备注Result 交易返回特征码 两位数字 见接口返回值特征码说明CARDNO 卡号 卡号，不按卡号查询时设置为 0COPNO 商户号 商户号，必填项，用于验证交易授权码IDNum 绑定号 身份证或手机号码返回值

19、TmnNo 终端号具体示例 参考储值消费示例示例返回结果 储值消费示例测试实例：卡号：16801155000001261680115500000133商户号：1155终端号：11552001授权码：NV41VDlSNldhFTFeYw0z领卡激活提交http:/ - 11 1680115500000125 交易(储值充值)提交http:/ - 11 (11)交易成功！ 00006698 200 1680115500000125 储值充值 重置卡密码提交http:/ - 11 1680115500000125 修改/重置密码 获得交易流水提交http:/ 返回语言种类&LICENSEKEY=Zg

20、04WTBbNldjFzVaZAoy 交易授权码&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只能用 终端号，卡号，交易流水

21、号中的一个来条件来查询，这 3 个参数都为 0 时按商户号来查询时间为可选项，不需要时设置为 0返回- - 00000053 1680010500000006 11000.00 0.00 2007-06-01 13:27:37 10051001 充值撤销 - 00000052 1680010500000006 11000.00 0.00 2007-06-01 13:19:45 10051001 储值消费 省略 修改或查询用户信息查询提交http:/ - 1680115500000125 1155 0000-00-00 修改提交http:/ - 1680115500000125 1155 ceraki 13611935449 0000-00-00 绑定/ 绑定撤销手机号&IDNUM=手机号&TRADEMODE=1 是绑定 0 是绑定撤销post:绑定http:/ - 11 1680115500000125 1155 13611935449 11552001 post:绑定撤销http:/ - 11 1680115500000125 1155 13611935449 11552001 */