FMKCAS(金融促销电子券接口代理)系统调SPC发券服务
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
appMethod | String | Y | suning.custom.category.query | 方法名 |
appRequestTime | String | Y | 2012-04-25 20:23:30 | 时间戳,格式为yyyy-MM-dd HH:mm:ss,例如:2012-04-25 20:23:30。API服务端允许客户端请求时间误差为10分钟。 |
format | String | N | XML | 默认xml,可指定格式为xml,json |
appKey | String | Y | b0c332a133c102765f39de********** | 分配给应用的访问令牌 |
versionNo | String | Y | v1.2 | API的版本,目前为v1.2版本 |
signInfo | String | Y | 460d7ff15b073e463125b4********** | appSecret,appMethod ,appRequestTime, appKey, versionNo, 请求报文base64加密后的数据顺序MD5(32位小写),其中appSecret为appKey对应的密钥 |
access_token | String | N | a1c5c62b08df3a3cbf7efd********** | 采用OAuth授权方式为必填参数 |
名称 | 类型 | 是否必须 | 示例值 | 描述 |
---|---|---|---|---|
requestId | String | Y | 05257b0a296d40439a9ad212da196a84 | 请求号(请求端唯一标识号(UUID),建议各系统加上各自的标识,以防止系统间重复) |
invoker | String | Y | ossas | 统一传 ossas |
requestNo | String | Y | a018ec2c289e448f8341f07eb3195a37 | 流水号(控制重复调用,相同业务流水和调用方标识会幂等返回) |
activityCode | String | Y | SFZF20290330M011111 | 活动编码(根据活动编码前缀判断券类型) |
memberId | String | Y | 1900211111 | 易购会员号(新人券必传) |
requestKey | String | N | dkjfkdj | 秘钥 |
businessScene | String | Y | USER_PULL_DOWN | 业务场景(手工发券:MANUAL_PULL_DOWN用户领取:USER_PULL_DOWN(直接领:001(免息券))兑换:REDEEM_PULL_DOWN满返:FULL_BACK抽奖:002) |
terminalType | String | N | APP | 终端类型(PC、WAP、APP、TV APP_IOS、APP_ANDROID) |
buddleId | String | N | abcdef | APP包名(APP包名编码目前仅流量券、话费券必传) |
egoToken | String | N | TIvRyrNeojpnVnBk63Utga7e3 | 易购token(PC和WAP和APP可获取到则必传,易购二代机器指纹) |
appType | String | N | 03 | APP类型(01-金融,02-易购,03-小店,04-红孩子,05-其他) |
phoneNo | String | N | 13011111111 | 手机号 |
couponsAmount | String | N | 1 | 返券金额 |
clientIp | String | N | 192.168.1.1 | 用户IP(能够获取到必传) |
appToken | String | N | TIvRyrNeojpnVnBk63Utga7e3 | APP设备标识(APP必传,用于向风控数据支撑服务查询所有设备信息。) |
pcToken | String | N | TIvRyrNeojpnVnBk63Utga7e3 | PC设备标识(PC和WAP(包括微信)必传) |
idNo | String | N | 333333333333333333 | 用户实名身份证号码(新人券必传) |
realName | String | N | 你好S | 用户实名姓名(新人券必传) |
deliverSource | String | Y | ECOUPON-0003 | 发券来源 |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
responseCode | String | 0000 | 返回响应码(可选值:0000 - 成功,9999 - 系统异常,9998 - 参数校验不通过,9701 - 参数校验不通过,9711 - 调用会员系统出错,9766 - 风控提醒[交易有风险],9714 - 调用风控异常[调风控系统出错],9781 - 活动过期,9782 - 活动非生效,9783 - 终端规则不匹配,9784 - 调用电子券系统失败,9785 - 电子券系统发券失败,9787 - 参数非json格式数据,9788 - 该活动编码对应的活动不存在,9789 - 该活动当前发券时间不允许发券,9790 - 该app类型不符合活动规则要求,9791 - 该账号未实名,9792 - 该账号注册时间不符合活动要求,9793 - 流水号不可重复,9801 - 活动资源不够,9803 - 活动总次数用完,9804 - 活动每天次数用完,9805 - 活动每周次数用完,9806 - 会员号活动期间总次数用完,9807 - 会员号活动每天次数用完,9808 - 会员号活动每周次数用完,9809 - 身份证活动期间总次数用完,9810 - 身份证活动每天次数用完,9811 - 身份证活动每周次数用完,9812 - 手机号活动期间总次数用完,9813 - 手机号活动每天次数用完,9814 - 手机号活动每周次数用完,9815 - 终端号活动期间总次数用完,9816 - 终端号活动每天次数用完,9817 - 终端号活动每周次数用完,9967 - 您的签约手机号已享受过优惠,9968 - 您的签约手机号本日享受过优惠,9969 - 您的签约手机号本周已享受过优惠,9970 - 您的签约银行卡号已享受过优惠,9971 - 您的签约银行卡号本日已享受过优惠,9972 - 您的签约银行卡号本周已享受过优惠,9873 - 会员等级不满足本活动规则要求,9724 - 调用消息平台发短信异常,9768 - 连接消息平台系统超时,10010001 - 活动时间未到,10010002 - 活动时间已结束,10010003 - 无绑定易购会员编号,10010004 - 非super正式会员,10010005 - 非super试用期会员 ,10010006 - 非super会员,10010007 - 调用付费会员等级接口失败 ,F410 - 非super新会员,F411 - 非super新会员或试用期会员,F417 - 您不是未激活会员,无法领取,F418 - 您还不是已激活未实名会员,无法领取,F419 - 您已经实名,无法领取,F420 - 您还不是初级实名会员,无法领取,F421 - 您已经高级实名,无法领取,F422 - 您还不是高级实名会员,无法领取,F423 - 您还不是实名会员,无法领取,F424 - 您还不是激活会员,无法领取,F425 - 连接PLPPPS系统超时,F426 - 连接PLPPPS系统出错,F427 - 任性付已开通,F428 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已注销),F429 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已失效),F430 - 您的账户状态异常,暂无法领券,如有疑问请联系客服95177转5。(任性付资格已冻结),9840 - 任性付未申请,F432 - 您已拥有免息资格,无需领券,直接下单体验吧!,F433 - 实名来源[%s]不满足,F434 - 实名时间段[%s]不满足,F435 - 调用会员系统出错[%s],F436 - 当前活动时间段内发券总次数已用完,F437 - 任性付资格开通时间段[%s]不满足,F439 - 未开通任性贷 该券仅限开通任性贷的用户领取,F440 - 连接PLPLMS系统超时 领券人数太多,请稍后再试,F441 - 连接PLPLMS系统异常 领券人数太多,请稍后再试,F442 - 任性贷资格开通时间段[%s]不满足 任性贷开通时间不满足活动的要求,F443 - 拦截高危会员,任性付高危用户拦截。) |
responseMsg | String | dkjdfk你好 | 返回错误消息 |
couponType | String | 1 | 1 –免息券 2 –众筹券 3 –流量券 4 –话费券 5 –理财券 6 –特权券 7 –支付券 8 –基金券 9 –购物免息券 10 –借款免息券 11 –还款免息券 |
couponNo | String | SNLCLJ201711020000944266 | 券号 |
valueType | String | 1 | 券面值类型(1-定额;2-折扣;3-加息) |
couponAmount | String | 5 | 券金额\券上限金额(单位为分,与券折扣不共存 券面值类型为3时非空。) |
couponDiscount | String | 80 | 券折扣(如 80即为0.8%,与券金额不共存 券面值类型为3时非空。任性付免息券是百分位,其他券时万分位) |
couponStatus | String | 02 | 券状态(01:发券新建;02:发券成功;03:发券失败;04:发券异常) |
startTime | String | 2020409195812 | 券有效期开始日期(格式:yyyyMMddHHmmss) |
endTime | String | 2020409195904 | 券有效期结束日期(格式:yyyyMMddHHmmss) |
couponDesc | String | 仅限平台使用 | 券使用规则 |
pcLink | String | http://www.suning.com | pc活动链接 |
wapLink | String | http://www.suning.com | wap活动链接 |
appLink | String | http://www.suning.com | app活动链接 |
yfbLink | String | http://www.suning.com | 易付宝链接 |
<sn_request> <sn_body> <createFmkcasdelivercoupon> <buddleId>abcdef</buddleId> <requestKey>dkjfkdj</requestKey> <appToken>TIvRyrNeojpnVnBk63Utga7e3</appToken> <invoker>ossas</invoker> <requestNo>a018ec2c289e448f8341f07eb3195a37</requestNo> <idNo>333333333333333333</idNo> <phoneNo>13011111111</phoneNo> <terminalType>APP</terminalType> <activityCode>SFZF20290330M011111</activityCode> <businessScene>USER_PULL_DOWN</businessScene> <realName>你好S</realName> <requestId>05257b0a296d40439a9ad212da196a84</requestId> <appType>03</appType> <couponsAmount>1</couponsAmount> <clientIp>192.168.1.1</clientIp> <egoToken>TIvRyrNeojpnVnBk63Utga7e3</egoToken> <pcToken>TIvRyrNeojpnVnBk63Utga7e3</pcToken> <deliverSource>ECOUPON-0003</deliverSource> <memberId>1900211111</memberId> </createFmkcasdelivercoupon> </sn_body> </sn_request>
{ "sn_request": { "sn_body": { "createFmkcasdelivercoupon": { "buddleId": "abcdef", "requestKey": "dkjfkdj", "appToken": "TIvRyrNeojpnVnBk63Utga7e3", "invoker": "ossas", "requestNo": "a018ec2c289e448f8341f07eb3195a37", "idNo": "333333333333333333", "phoneNo": "13011111111", "terminalType": "APP", "activityCode": "SFZF20290330M011111", "businessScene": "USER_PULL_DOWN", "realName": "你好S", "requestId": "05257b0a296d40439a9ad212da196a84", "appType": "03", "couponsAmount": "1", "clientIp": "192.168.1.1", "egoToken": "TIvRyrNeojpnVnBk63Utga7e3", "pcToken": "TIvRyrNeojpnVnBk63Utga7e3", "deliverSource": "ECOUPON-0003", "memberId": "1900211111" } } } }
<sn_responseContent> <sn_body> <createFmkcasdelivercoupon> <yfbLink>http://www.suning.com</yfbLink> <couponNo>SNLCLJ201711020000944266</couponNo> <responseCode>0000</responseCode> <couponDiscount>80</couponDiscount> <couponAmount>5</couponAmount> <appLink>http://www.suning.com</appLink> <couponType>1</couponType> <valueType>1</valueType> <couponStatus>02</couponStatus> <couponDesc>仅限平台使用</couponDesc> <startTime>2020409195812</startTime> <wapLink>http://www.suning.com</wapLink> <endTime>2020409195904</endTime> <pcLink>http://www.suning.com</pcLink> <responseMsg>dkjdfk你好</responseMsg> </createFmkcasdelivercoupon> </sn_body> </sn_responseContent>
{ "sn_responseContent": { "sn_body": { "createFmkcasdelivercoupon": { "yfbLink": "http://www.suning.com", "couponNo": "SNLCLJ201711020000944266", "responseCode": "0000", "couponDiscount": "80", "couponAmount": "5", "appLink": "http://www.suning.com", "couponType": "1", "valueType": "1", "couponStatus": "02", "couponDesc": "仅限平台使用", "startTime": "2020409195812", "wapLink": "http://www.suning.com", "endTime": "2020409195904", "pcLink": "http://www.suning.com", "responseMsg": "dkjdfk你好" } } } }
异常码 | 错误描述 | 解决方案 |
---|---|---|
biz.custom.createfmkcasdelivercoupon.enumeration-error:* | 参数的可选值错误 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createfmkcasdelivercoupon.missing-parameter:* | 参数必填 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createfmkcasdelivercoupon.format-error:* | 参数格式错误 | 请检查此参数的值,*号表示参数字段名 |
biz.custom.createfmkcasdelivercoupon.length-overlong:* | 参数的值超过规定长度 | 请检查此参数的值,*号表示参数字段名 |
isp.sys.service.unavailable.fmkcas | 服务不可用 | 请联系苏宁技术人员 |
异常码 | 错误描述 | 解决方案 |
---|---|---|
sys.check.user-permission:inexistence | 访问令牌不存在 | 更换访问令牌 |
sys.check.user-permission:overdue | 访问令牌已过期 | 请使用刷新令牌刷新 |
sys.check.api-permission:inexistence | Api方法不存在 | 请参考帮助中心 |
sys.check.api-permission:overdue | Api方法已过期 | 请参考帮助中心 |
sys.check.method-permission:authority | 无权操作此api | 确认是否有访问该方法权限 |
sys.auth.vendor-request:errory | 无权操作此供应商 | 请确认供应商编码是否正确 |
sys.controller.api-request:limit | Api请求受控 | 超过请求次数 |
sys.check.app-time:error | 请求参数错误api请求时间误差大 | 参考帮助中心 |
sys.check.request-params:error | 请求报文结构错误 | 参考帮助中心、日期格式等 |
sys.check.starttime-format:error | 请求开始时间错误 | 参考帮助中心、日期格式等 |
biz.handler.data-get:success | 业务数据查询成功 | 无 |
biz.handler.data-get:fail | 业务数据查询失败 | 检查请求条件 |
biz.handler.data-get:no-result | 业务数据结果为空 | 无 |
sys.check.pageno-format:error | pageNo格式错误,只允许1到99999之间的整数 | 检查pageNo输入是否有误 |
sys.check.pagesize-format:error | pageSize格式错误,只允许1到50之间的整数(订单相关是1到100) | 检查pageSize输入是否有误 |
sys.check.page-param:error | pageNo或者pageSize不在要求范围内,pageNo只允许1到99999之间的整数,pageSize只允许1到50之间的整数(订单相关是1到100) | 检查pageNo和pageSize输入是否有误 |
sys.check.miss-time:starttime | 不存在开始时间(节点) | 检查输入 |
sys.check.miss-time:endtime | 不存在结束时间(节点) | 检查输入 |
sys.check.starttime-value:null | 开始时间为空(值) | 检查输入 |
sys.check.endtime-value:null | 结束时间为空(值) | 检查输入 |
sys.check.starttime-format:error | 校验开始时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.endtime-format:error | 校验结束时间不合法,格式yyyy-MM-dd HH:mm:ss | 检查时间格式 |
sys.check.query-time:error | 开始时间是否小于结束时间 | 检查开始和结束时间大小 |
sys.check.query-time:outofrange | 时间查询是否超出指定范围 | 检查时间范围 |
sys.check.app-sign:null | 签名信息为空 | 检查签名信息 |
sys.check.app-sign:error | 签名信息错误 | 检查签名信息 |
sys.check.missing-parameter:apiversion | API版本号未指定 | 检查API版本号 |
sys.check.missing-parameter:appRequestTime | 请求时间丢失 | 检查请求时间 |
sys.check.missing-nestElement:sn_body | 缺少sn_body节点 | 检查sn_body是否存在 |
sys.check.user-permission:inexistence | 用户key不存在 | 检查用户key是否存在 |
biz.handler.batch-handler:no-support | 非查询类API不支持批量操作 | 检查API类型 |
biz.handler.request-message:error | 查询类API输入多个业务节点 | 检查业务节点 |
sys.check.header-param:null | header参数为空 | 请检查header参数 |
sys.controller.api-access:limit | 访问限制 | 无 |
sys.controller.api-frequency:limit | 访问频率限制 | 无 |
sys.error.network:failure | 网络异常 | 无 |
sys.error.network-status:? | 响应失败 ?为状态码 | 无 |
sys.check.snunionid.length.is.not:48 | 混淆会员编码长度不是48位 | 使用转换器转换混淆会员编码规定要求混淆会员编码48位 |