手机WAP支付项目操作手册

手机WAP支付项目操作手册当前版本-版本号V1.0修改日期：2007-10-16文档状态(完成)作者:朱博1修订历史记录日期版本说明作者2007年10月16日V1.0创建文档朱博2目录一．手机WAP支付产品简介......................................................................41、产品定义...............................................................................42、产品特点...............................................................................43、适用对象...............................................................................44．名词定义...............................................................................4二．手机WAP支付流程演示......................................................................51.登陆....................................................................................52.查询帐户信息............................................................................73.手机WAP支付.............................................................................84.查询消费信息............................................................................95.查询交易信息（系统管理员）.............................................................10三.接口开发................................................................................11四.FAQ.....................................................................................163一．手机WAP支付产品简介1、产品定义“手机WAP支付”项目是环迅IPS自主开发的基于IPS帐户扣款的手机WAP支付平台，为商户和用户提供完整，便捷，易用的无线支付解决方案。2、产品特点消费者可以在IPS合作WAP站点上购物下单，选择IPS支付，通过IPS账户进行WAP支付，也可以随时随地登录IPS的WAP站点后查询IPS账户信息。3、适用对象“手机WAP支付”产品适用的服务对象为：手机WAP购物、手机WAP缴费、手机WAP理财、移动电子商务付费等类别个性化服务，具体业务包括：查缴手机话费、动感地带充值、个人账务查询、购买彩票、手机订报、购买数字点卡、电子邮箱付费、手机捐款、远程教育、手机投保、公共事业缴费等。4．名词定义WAP：WAP（无线通讯协议）是在数字移动电话、因特网或其他个人数字助理机（PDA）、计算机应用之间进行通讯的开放全球标准。现在很多人直接用WAP来代表手机上网。WAP的本质就是INTERNET，而且是可以移动的INTERNET。4二．手机WAP支付流程演示1.登陆z功能说明消费者可以直接通过手机登录IPS手机WAP站点：支付，直接登录到IPSWAP站点首页登陆IPS帐户。z步骤1）消费者可以用手机登录IPS手机WAP站点：站点首页，如图1；图12）消费者可以选择“邮件地址”的登录类型进行登陆，进入登陆页面后输入用户在环迅IPS注册的邮件地址和登陆密码登陆IPS帐户，如图2；图23）消费者可以选择“用户名称”的登录类型进行登陆，进入登陆页面后输入用户在环迅IPS注册的用户姓名和登陆密码登陆IPS帐户，如图3；5图34）消费者可以选择“IPS帐号”的登录类型进行登陆，进入登陆页面后输入用户在环迅IPS注册的IPS帐号和登陆密码登陆IPS帐户，如图4；图45）消费者选择登录类型登陆成功后，可以进入IPS“帐户信息”页面查询用户在环迅IPS帐户的消费信息，如图5；图562.查询帐户信息z功能说明消费者可以通过手机登录IPS手机WAP站点：，登录成功后可以查询消费者的IPS账户信息。z步骤1）消费者通过手机登录IPS手机WAP站点：登录成功后，可以进入IPS“帐户信息”页面查询用户在环迅IPS帐户的消费信息，如图6；图62）消费者点击“帐户信息”可以查询到消费者在IPS帐户里的帐户信息，包括爱米与人民币的帐户余额（默认单位为元），如图7；图773.手机WAP支付z功能说明消费者在IPS合作商家WAP站点上购物下单，选择IPS支付，就能够通过IPS账户进行WAP支付。z步骤1）消费者通过手机登录商家手机WAP站点，选择IPS支付，可以输入IPS帐户EMAIL和交易密码进行支付，如图8；图82）消费者输入正确的IPS帐户EMAIL和交易密码进行支付，支付成功后显示支付订单号和帐户剩余金额，如图9。图984.查询消费信息z功能说明消费者可以登陆环迅IPS网站平台支付的详细交易信息。z步骤1)消费者登录环迅IPS网站点击“交易管理”菜单后点击“WAP交易”模块，可以查询通过IPSWAP支付平台支付的明细，如图10；图102）消费者输入正确的商户订单号或IPS订单号，选择交易的起始日期和结束日期可以查询该时间段内通过环迅WAP支付平台支付的订单的明细，如图11。图1195.查询交易信息（系统管理员）1)IPS系统管理员可以登录IPS3.0系统后台点击“交易管理”菜单后点击“交易查询”模块，可以查询通过IPSWAP支付平台支付的明细，如图12；图122）IPS系统管理员输入正确的商户订单号或IPS订单号，支付银行选择“IPS账户”，交易类型选择“消费交易”，选择交易的起始日期和结束日期可以查询该时间段内通过环迅WAP支付平台支付的订单的交易明细。10三.接口开发z开发前准备工作取得商户在IPS的6位商户号及密码，初始密码以邮件形式通知商户，到IPS的网站首页，登陆商户后台修改密码以保证商户后台系统安全。z订单支付接口开发1)Form表单提交（Post方式）持卡人在商户网站选购完商品后，商户生成订单，订单页面中应含有订单支付表单，用来向IPS提供该笔订单的详细信息和商户自己的详细信息。订单支付信息通过Form表单以Post方式递交给IPS，表单提交方式采用Post隐含域方式。2)订单提交URL正式环境：请提交至)订单支付接口表单参数参数长度参数名称是否为空说明举例Mer_code6位商户编号NotNull说明：IPS支付平台分配给商户的唯一标识000015必须填写Billno30位商户订单编号NotNull规则：30位以下的订单号000001000123必须填写AmountMax(10位)订单金额NotNull单位：人民币规则：小数点后保留2位,若超过2位则在IPS平台上自动四舍五入13.45必须填写Currency_Type3位币种NotNull规则：当前只有RMB必须填写BillDate8位订单日期NotNull规则：YYYYMMDD20031205必须填写merchantUrl255位取消支付返回页面URLNotNull规则：当用户点击取消的时候返回的商户的地址。必须填写11OKUrl支付结果成功返回的商户URL规则：当用户支付成功的时候返回的商户的URL。可选项FailUrl255位支付结果失败返回的商户URL规则：当用户支付失败的时候返回的商户的URL。可选项Attach1024位商户数据包Null说明：存放商户自己的信息，随订单传送到IPS平台，当订单返回的时候原封不动的返回给商户可选项OrderEncodeType1位订单支付接口加密方式NotNull说明：存放商户所选择订单支付接口加密方式。1：订单支付采用Md5的摘要认证方式点击查看详细说明必须填写RetEncodeType2位交易返回接口加密方式Null说明：存放商户所选择的交易返回接口加密方式。10：老接口（与老系统兼容）11：交易返回采用Md5WithRsa的签名认证方式12：交易返回采用Md5的摘要认证方式可选项RetType1位返回方式Null说明：IPS为商户提供了2种返回方式，分别为：ServertoServer返回（可选）Browser返回（必选）该字段存放商户是否选择ServertoServer返回方式可选项120：不选1：选择ServerUrl255位ServertoServer返回页面商户使用ServertoServer返回时可将返回地址存于此字段当RetType=1时,本字段有效可选项SignMD5255位订单支付接口的Md5摘要Null说明：若OrderEncodeType字段的值设置为2时，需同时在此字段中传入Md5摘要.Sigmd5=订单号+金额(保留2位小数)+日期+支付币种+IPS证书可选项4)订单支付接口MD5摘要认证在IPS3.0系统中，IPS为商户订单支付接口提供了MD5摘要认证，以保证数据不被非法篡改。商户可以使用MD5摘要1、OrderEncodeType设置为2，且在订单支付接口的signmd5字段中存放MD5摘要认证信息。交易返回接口MD5摘要认证的明文信息如下：【订单编号】+【订单金额】+【订单日期】+【币种】+【商户内部证书字符串】注：商户内部证书指商户在IPS存储的一个1024位的字符串,请商户在每次更新这个证书的同时,同步更新您的程序。z交易返回接口开发1)Form表单返回（Get方式）交易订单用Form的方式返回到商户提交的Merchanturl中。商户在返回页面接受由IPSGET方式传送的数据，进行处理。2)交易返回接口表单参数参数长度参数名称是否为空说明举例billno30位订单编号NotNull对应订单支付接口的【订单编号—Billno】参数00000100012313mercode6位商户编号说明：IPS支付平台分配给商户的唯一标识000015Currency_type3币种NotNull支付币种RMBamountMax(10位)订单金额NotNull对应订单支付接口的【订单金额—Amount】参数13.45date8位订单日期NotNull对应订单支付接口的【订单日期—Date】参数20031205succ1位成功标志NotNullY:支付成功；N：支付失败Ymsg255位发卡行的返回信息Null银行交易结束后给予的支付结果提示无效卡号attach1024位商户数据包Null对应订单支付接口的【商户数据包—Attach】参数ipsbillno18位IPS订单号Null商户订单在IPS的唯一编号retencodetype2位交易返回签名方式Null返回给商户其所选用的交易返回签名方