布优API点卡接口说明文档.doc

布优API点卡接口开发指南商户接口规范版本()目录第一章 文档描述 31、 文档说明 32、 阅读对象 3第二章 系统原理 31、 术语定义 32、 消费流程 43、 查询流程 54、 系统加密 6第三章 点卡接口定义 61、 同步过程接口定义(商户系统发起请求) 62、 下行异步通知过程接口定义(布优接口发起请求) 8附录1:布优支付接口卡类型说明 9文档描述文档说明本说明文档用于指导布优API商户实现与布优API点卡接口的顺利对接。请相关技术人员详细阅读本文档。阅读对象商户开发人员。四川布优网络科技限公司布优API点卡接口相关技术人员。系统原理术语定义商户:指已独立拥有在线销售系统,并成为布优API点卡接口系统会员,且已使用或者将使用布优API点卡接口实现收付费或其他相关功能需求的企业或者个人。外部接入接口:指布优API通过统一的方式接受外部请求的接口。商户系统:指使用布优API外部接入接口的计算机系统,一般指商户所拥有的在线销售系统。用户:指在商户系统内进行消费的企业或者个人。商户ID:指布优API为使用外部接入接口的商户统一分配的唯一标识。商户密钥:指商户在和布优API确定合作意向时布优API为商户提供的16位字符串。该信息作为商户系统和布优API交互时身份确认的依据,需商户妥善保管。消费流程一般地,在商户系统进行消费时,用户需要向商户支付一定的相关费用。在集成了布优销卡接口后,布优销卡将为商户提供方便的收付费服务。用户在商户系统发起消费请求后,商户系统和布优销卡卡类接口系统(简写为布优接口)的交互流程如下图:图1商户系统和布优接口交互流程具体地,用户的一次消费中,商户系统和布优接口之间会发生2次直接交互过程。1、同步过程用户在商户系统选择产品或服务,填写订单(如用户选择卡面值、输入卡号、密码等)后,商户系统将用户填写的信息(如卡号、密码、类型、商户系统订单号等)以及相应的参数(如订单金额、商户ID和密钥、异步通知地址等信息)组织为订单信息,通过httpget/post方式提交到布优接口,该过程如图1箭头1所示。当商户系统提交订单到布优接口时,布优接口将同步返回数据给商户系统。商户系统根据该同步返回结果判断订单是否成功提交到布优接口。若订单提交成功,商户系统需等待布优接口的异步通知结果。注意,在收到异步结果之前,商户系统不能对系统内的订单进行成功或者失败处理。若订单提交失败,商户系统需将系统内订单做失败处理。该过程如图1箭头2所示。2、异步过程布优接口将订单处理完成后会异步通知商户系统订单处理结果(通过httpget方式),商户系统需要先验证返回结果的合法性,并根据合法的异步通知的结果,对商户系统的订单进行操作。若异步通知返回充值成功,则商户系统可对订单进行成功操作。注意,实际的订单金额可能和用户提交的订单金额不一致,商户系统必须以布优接口异步通知返回的订单实际金额为准。若异步通知返回充值失败,则商户系统可对订单进行失败操作。该过程如图1箭头4所示。商户系统在成功接收布优接口异步通知的订单结果后,需同步返回1个结果“ok”(页面内不能有其他的任何代码)给布优接口(不论订单结果成功与否),当布优接口收到该结果“ok”后便不再通知商户系统,否则布优接口将根据同商户的约定重复通知商户系统。该过程如图1箭头5所示。如果商户系统将订单成功提交到布优接口后,未收到布优接口的异步通知结果,商户可登陆布优接口商户系统https://手动重发订单结果通知。需特别注意,当未收到布优接口异步通知结果时,商户系统不能对订单状态进行任何操作,否则造成的损失商户自己承担。查询流程在商户系统将订单成功提交给布优接口后的任意时间,商户系统可发起请求查询订单的处理结果。该流程由商户系统发起,由接口返回相应结果。系统加密布优API采用MD5加密方式对传输数据进行签名验证,具体请参考相关接口定义。对MD5加密后的签名值,请注意结果的大小写务必正确。为了确保签名值不是因为MD5加密算法而导致结果不正确,请各商户在调用接口前对字符串1234567890abcdefghijklmnopqrstuvwxyz使用MD5加密算法进行加密,44c1bf24e7abec6则表示MD5加密正常。点卡接口定义同步过程接口定义(商户系统发起请求)接入URL:/(最新地址)接入方式:GET方式请求协议参数:表1同步过程请求协议参数说明参数名参数可空加入签名说明商户IDpartnerNY商户id,由布优API分配卡类型cardtypeNY卡类型,具体参考附录1卡号cardnoNY卡号密码cardpwdNY密码金额paymoneyNY单位元(人民币),无小数商户订单号ordernumberNY商户系统订单号,该订单号将作为布优接口的返回数据。该值需在