1、贺喜 支付平台商户接口文档 http:/贺喜多途径支付平台定单后台通知系统商户接口规范株洲市和谐网络科技发展有限公司2007.08.26贺喜 支付平台商户接口文档 http:/目 录1. 文档介绍 .21.1.1. 读者对象 .21.1.2. 版权声明 .21.1.3. 功能介绍 .22. 如何开启定单后台通知系统 .23. 定单后台通知系统参数说明 .24. 处理结果返回 .35. 定单后台通知周期 .31. 文档介绍1.1.1. 读者对象商户系统设计人员、编程人员及测试人员1.1.2. 版权声明此文档版权归株洲市和谐网络科技发展有限公司所有。作为本系统的最终用户，可以拥有该份文档的使用权，
2、但未征得株洲市和谐网络科技发展有限公司的书面批准，不得向第三方借阅、出让、出版该文档。1.1.3. 功能介绍为防止因用户浏览器端返回失败原因而漏单、挂单的现象而推出此系统。当消费者在商户处完成订单提交并在贺喜支付平台完成支付后，贺喜支付平台服务器通过后台通知的方式将此次支付的结果发送给商户接收程序（3 部分） ，接收程序收到通知后向贺喜支付平台返回处理成功的信息。贺喜 支付平台商户接口文档 http:/Copyright 株洲市和谐网络科技发展有限公司 2005-20072. 如何开启定单后台通知系统登录商户管理区（http:/） ，进入“支付平台”“参数设置” ，在“定单服务器端通知设置”栏
3、选择“启用”选项， “通知地址”栏输入已经设计好的通知程序在商户网站的绝对网址，如“http:/ 定单后台通知系统参数说明用途：支付完成后，贺喜支付平台通过服务器端将支付成功信息通知给商户。示例程序：payreceive_notify.asp、payreceive_notify.php、payreceive_notify.jsp信息格式：通知格式示例：notify_url?v_orderid=v_orderid&v_orderdate=v_orderdate&v_price=v_price&v_billno=v_billno&v_custom1=v_custom1&v_custom2=v_cu
4、stom2&v_mobileno=v_mobileno&v_servicename=v_servicename&v_payvia=v_payvia&v_payviastr=v_payviastr&v_md5=v_md5&v_pstatus=v_pstatus&v_pstring=v_pstring&v_server=1该表单格式详细解释如下：notify_url 是商户在管理区设置的定单后台通知地址，即贺喜支付平台服务器端通知定单信息的程序地址，表单参数与用户端返回类似，新增v_server 参数，值固定为 1，表单采用 “GET”方式提交定单通知。贺喜 支付平台商户接口文档 http:/Co
5、pyright 株洲市和谐网络科技发展有限公司 2005-2007变量名称 变量命名 返回值说明订单号 v_orderid 贺喜支付平台反馈的订单号订单成交时间 v_orderdate 订单支付成功的时间订单成交价格 v_price 以分为单位商户订单号 v_billno 商户提交的订单号自定义字段 1 v_custom1 商户提交的自定义字段 1自定义字段 2 v_custom2 商户提交的自定义字段 2用户手机号码 v_mobileno 短信注册专用参数，返回用户手机号码服务名称 v_servicename 商户提交的服务名称支付方式 v_payvia 用户选择的支付方式参数支付方式中文名
6、称 v_payviastr 用户选择的支付方式中文名称，如“声讯电话支付”订单 MD5 校验码 v_md5 该参数的 MD5 字符串的顺序为：v_orderid+v_billno+v_custom1+v_custom2+v_price+v_payvia+reg_userid+v_pstatus+paykeyMD5 字符串示例：1-458888200702251631443706abcd1 128881paykey用 MD5 函数加密上述字符串后得到的值如果和 v_md5 值相等即表明返回的信息没有被纂改订单返回值 v_pstatus 订单支付结果反馈的字符串1：支付成功0：支付失败支付状态说明
7、 v_pstring 支付状态中文说明，成功值：支付成功定单通知方式 v_server 值固定为 1，表示为服务器端通知表 1特别注意：启用定单后台通知系统后，一个成交订单商户一般至少会收到用户端和服务器端两次通知，请商户一定要在返回程序和通知接收程序中设置定单查重功能，以避免定单重复充值。如果商户没有设置定单查重功能，请不要启用本系统。4. 处理结果返回商户接收到贺喜支付平台服务器端通知后需要向贺喜支付平台返回处理成功或失败的信息，商户成功接收通知并处理成功，请返回无 HTML 代码的纯字符“Y ”，除此之外的任何字符都被认为是处理失败。处理结果返回示例请参照范程。5. 定单后台通知周期贺喜支付平台服务器每五分钟向商户通知程序发送已成交且未通知订单信息，最多通贺喜 支付平台商户接口文档 http:/Copyright 株洲市和谐网络科技发展有限公司 2005-2007知三次。
