短信验证码支付平台接口-完整版1.0 (1).doc

北京盛峰验证码支付平台接口文档北京盛峰验证码支付平台接口文档北京盛峰远景文化传播有限公司2015年5月版本控制信息版本日期拟稿和修改说明1.02015-05-14北京盛峰技术部初稿本文档中的所有内容为北京盛峰验证码支付的机密和专属所有。未经北京盛峰远景文化传播有限公司的明确书面许可，任何组织或个人不得以任何目的、任何形式及任何手段复制或传播本文档部分或全部内容。目录1.支付流程- 4 -1.1验证码支付平台流程：- 4 -1.2支付流程详细说明：- 4 -2.获取验证码接口- 5 -2.1获取验证码接口：- 5 -2.2获取验证码请求返回信息- 5 -3.提交验证码接口- 6 -3.1提交验证码接口：- 6 -3.2提交验证码请求返回信息- 7 -4.回调商户充值接口- 7 -4.1回调商户充值接口：- 7 -4.2充值请求返回信息- 8 -5.IP限制- 8 -6.返回结果MessageId说明- 8 -7.其它约定- 9 -1.支付流程1.1验证码支付平台流程： 流程图如下：盛峰支付平台商户系统用户机1,用户填写手机号发起支付请求2.商户系统向盛峰获取验证码与指令3.处理请求4,下发支付验证码(动态)5,返回下发验证码结果,与指令信息 6,调用用户发件箱后台上行指令8,商户系统向盛峰提交验证码请求支付7,用户填写验证码,确认支付9.处理请求10,返回提交验证码结果11,下发成功订购业务短信13,为用户充值对应的商品12,通知合作方计费成功结果14,返回充值结果,直接页面打印1.2支付流程详细说明：1、用户选择商品,填写手机号,使用验证码方式支付；2、商户系统向验证码支付平台请求获取验证码(详情阅读2.1)；3、验证码支付平台向用户手机下发验证码；4、验证码支付平台返回下发验证码结果标识与指令信息(详情阅读2.2)；5、商户系统获取到指令信息后台调用用户发件箱上行指令；6、用户页面填写手机收到的验证码，确认付费；7、商户系统向提交验证码,请求支付(详情阅读3.1)；8、验证码支付平台返回提交验证码结果(详情阅读3.2)；9、验证码支付平台向用户下发成功订购短信提醒；10、通知商户系统计费成功结果(详情阅读4.1)；11、商户系统为用户充值商品；12、商户系统返回充值结果给验证码支付平台(详情阅读4.2)；2.获取验证码接口2.1获取验证码接口：u 接口描述商户系统提交手机号获取验证码,验证码支付系统返回对应的信息u 发起方商户系统u 接收方盛峰验证码支付平台u 接口形式HTTP POST 方式接口地址: /IYZM/GetCode.ashx示例: /IYZM/GetCode.ashx?Prim= oP2T4VE5RBEkNEY6cgNYVL0bgPeCNPEC7ZP9DoPFzQOD10jAmPH0iUoePPnyiNP4tMvMCloIo2uwYynTNxPsrQ=&MchId=RTESTu 接口参数格式定义PrimPrim =AesEncrypt(MchNoFeeMobile)需AES加密,各参数用拼接后加密MchNo商户订单号,要求唯一,不超过50位Fee资费,单位元,如 Fee=2Mobile用户支付号码,长度11位MchId公司编码,由盛峰远景分配,公司唯一标识2.2获取验证码请求返回信息返回信息直接输出至页面MessageIdMsgPayChannelMoSmsMsg如:000success10655454wo&c7eabc3e-15bc-4777-be89-1ca9d82d22ef&SFTEST&SFQD89380576372766373参数说明:MessageId:结果编码(详见 6.返回结果MessageId说明)Msg:状态描述PayChannel:支付通道,如10655454MoSmsMsg:用户上行短信内容,如: wo&c7eabc3e-15bc-4777-be89-1ca9d82d22ef&SFTEST&SFQD89380576372766373注:如果PayChannel或MoSmsMsg长度小于1,则无需上行指令3.提交验证码接口3.1提交验证码接口：u 接口描述获取验证码成功后,商户系统向盛峰验证码支付平台提交验证码确认计费u 发起方商户系统u 接收方盛峰验证码支付平台u 接口形式HTTP POST 方式接口地址: /IYZM/SendCode.ashx示例: /IYZM/SendCode.ashx?Prim= oP2T4VE5RBEkNEY6cgNYVL0bgPeCNPEC7ZP9DoPFzQOD10jAmPH0iUoePPnyiNP4tMvMCloIo2uwYynTNxPsrQ=&MchId=RTESTu 接口参数格式定义PrimPrim = AesEncrypt(MchNoVCode)需AES加密,各参数用拼接后加密MchNo商户订单号, 与获取验证码MchNo一致VCode短信验证码MchId公司编码,由盛峰远景分配,公司唯一标识3.2提交验证码请求返回信息返回信息直接输出至页面MessageIdMsg如:000success参数说明:MessageId:结果编码(详见 6.返回结果MessageId说明)Msg:状态描述4.回调商户充值接口4.1回调商户充值接口：u 接口描述计费成功以后回调通知合作方为用户充值商品u 发起方盛峰验证码支付平台u 接收方商户系统u 接口形式HTTP POST 方式接口地址: http:/ip:port/XXX.XXX(合作方提供)示例: http:/ip:port/XXX.XXX?Prim= oP2T4VE5RBEkNEY6cgNYVL0bgPeCNPEC7ZP9DoPFzQOD10jAmPH0iUoePPnyiNP4tMvMCloIo2uwYynTNxPsrQ=&MchId=RTESTu 接口参数格式定义PrimPrim = AesEncrypt(MchNoFeeMobile)需AES加密,各参数用拼接后加密MchNo商户订单号,与获取验证码MchNo一致Fee资费,单位元,如 Fee=2Mobile付费手机号MchId公司编码,由盛峰远景分配,公司唯一标识4.2充值请求返回信息返回信息直接输出至页面MessageIdMsg如:000success参数说明:MessageId:结果编码(详见 6.返回结果MessageId说明)Msg:状态描述5.IP限制合作方IP：*.*.*.*北京盛峰:6,3,2,01,09, 8注:获取通道接口需鉴权请求ip,请商户提供服务器ip列表6.返回结果MessageId说明状态编码状态描述000成功（例如：000成功）111失败（例如：111失败）401参数错误（例如：401参数错误）403订单重复（例如：403订单重复）015IP受限（例如：0