第三方支付管理平台支付开发指南.doc

CMMB第三方支付管理平台开发指南Version: 1.0Public date: 2010-3-30All copyright reservedM第一章 文档描述1 文档说明本操作手册用来指导网上营业厅实现与CMMB第三方支付管理平台（下文简称POMP，payment-online manager platform ,或支付管理平台 ）支付网关系统的顺利对接。请相关技术人员详细阅读本手册。文中黑粗的内容表示要重点注意的内容。2 版本2010-3-30创建文档3 阅读对象开发人员4 接口联系人职责技术支持姓名王兴立电话EQQ457743485职责技术支持姓名曾章华电话EQQ122795791第二章 业务功能描述1 作业流程简述1) 网厅根据客户的支付行为生成订单，包括渠道编号、订单号、金额、等支付要素，并提交支付请求。2) 用户进入支付管理平台，选择支付方式并支付成功后，支付管理平台将后台调用方式将支付结果实时返回网厅。3) 网厅接收到支付成功请求后，输出反馈信息给支付管理平台，并完成相关业务逻辑。4) 支付管理平台接收到网厅返回的成功信息，再将用户引导回网厅页面。2 接口通知流程1) 返回结果在此通知接口模式中，网厅需要确保notice_url稳定可靠。该notice_url完成接收支付管理平台发送的支付结果信息，交易结果信息将以POST方式传递至网厅。支付管理平台只将支付成功的订单进行返回。在传送给网厅的参数中，包含使用支付管理平台私钥对交易结果数据的数字签名。网厅应该先用密钥验证该数字签名，确认该通知信息的合法性。然后完成相关业务逻辑。2) 输出反馈支付管理平台要求网厅notice_url输出以下代码：-window.location.href=http:/show_url; -不允许在notice_url中发生任何跳转，并要求网厅第一时间输出此为支付管理平台判断是否成功返回支付结果的唯一凭证。3) 用户返回支付管理平台接收到以上反馈信息后，将引导用户返回http:/show_url进行浏览3 安全控制1 支付管理平台与网厅间数据交互都使用加密，并使用数字签名进行数据验证，确保数据的完整性和不可抵赖性第三章 系统原理1 支付流程此处对其中步骤进行详细描述，请仔细阅读。流程说明：1. 用户进入网厅产品订购页面，并选择要订购的产品。2. 网厅向boss发送产品费用计算请求。3. boss计算出此次产品费用。4. boss把结果返回给网厅。5. 网厅收到boss返回的结果后，把费用返回给用户。6. 用户选择 网上支付。7. 网厅记录订单信息。8. 根据CMMB第三方支付管理平台的要求格式，生成请求格式，进入CMMB第三方支付平台交易页面。9. 用户选择第三方支付方式。10. CMMB第三方支付管理平台进行数据处理。11. CMMB第三方支付管理平台根据第三方支付平台的接口要求生成支付请求格式（各个支付平台的请求格式不同），并展示给用户确认。12. 用户确认进行支付确认13. 根据用户确认动作，CMMB第三方支付管理平台处理支付申请，进入第三方支付平台交易页面14. 用户在第三方支付平台上输入信息进行支付。15. 第三方支付平台验证交易单信息，生成支付引导页面展示给用户。用户填写付款账户信息，并确认提交。16. 第三方支付平台把处理结果后台通知到第三方支付管理平台。（16.1 如果是支付宝的话，页面会跳转到支付管理平台）17. 第三方支付管理平台验证通知结果的真实性。18. 第三方支付管理平台记录交易日志。19. 第三方支付管理平台把结果反馈给第三方支付平台。（19.1 如果是财付通的话，平台会跳转回支付管理平台）20. 第三方支付管理平台同时把处理结果也返回给网厅。21. 网厅对第三方支付管理平台返回的结果的真实性进行验证。22. 网厅记录数据处理结果。23. 网厅对boss发起订购通知。24. boss进行订购请求处理。25. 处理完后，把订购结果返回给网厅。26. 网厅记录boss处理结果。27. 并把处理结果返回给第三方支付管理平台。28. 第三方支付管理平台收到网厅通知后并跳转回网厅页面29. 网厅把结果展示给用户看。 第四章 支付请求接口协议1 接入URL/payment/pay-gate2 接入方式POST/GET方式 3 协议参数字段名填写类型说明cmdno必填业务代码,支付接口填 1 date必填网厅日期：如20100330desc必填交易的商品名称,120个字符60汉字内,不包含特殊符号如果有多个产品，用 连接.比如 中央一套精彩电影精彩体育purchaser_id必填用户id(casid)echannel_id必填渠道编号（ECID），由支付管理平台统一分配transaction_id必填交易号(订单号)，由网厅产生(建议顺序累加)，一对请求和应答的交易号必须相同）。transaction_id 为28位长的数值，其中前10位为渠道编号(ECID)，由支付管理平台统一分配；之后8位为订单产生的日期，如20050415；最后10位网厅需要保证一天内不同的事务（用户订购一次产品），其ID不相同。此订单号必须保持唯一，不能重复,支付管理平台根据此定单号通知网厅数据更新等。ec_orderno必填网厅内部的定单号，此参数仅在对账时提供,28个字符内。 total_fee必填总金额，以分为单位,不允许包含任何字符fee_type必填现金支付币种，目前只支持人民币，码编请参见附件中的notice_url必填接收支付管理平台通知结果的URL(推荐使用ip)attach必填渠道数据包，原样返回(如果无特殊用处，可传递 1 即可)sign必填MD5签名结果input_chartset选填输入编码，默认是utf-8(目前固定传递utf-8)4 签名规则顺序sign=md5(cmdno=1&date=20100330&echannel_id=4400101002&transaction_id=1000000301200512190000012138&ec_orderno=1111&total_fee=1300&fee_type=1¬ice_url=/tenpay1.aspx&attach=1&key=1000000301)以上拼凑值不要有空格！使用标准MD5算法对该字符串进行加密，加密结果全部转换成大写后，即为我们所需的订单MD5 校验码，将其写入sign字段即可。第五章 支付通知接口协议1 通知url用户提供的return_url2 通知方式Get 方式3 协议参数MD5支付通知目的URLnotice_url字段名填写类型说明cmdno必填任务代码 1pay_result必填支付结果，详见“返回值编码定义”, 0成功pay_info可选支付结果信息，支付成功时为空date必填网厅日期echannel_id必填渠道编码（ECID）transaction_id必填财付通交易号(订单号) ec_orderno必填网厅内部的定单号，此参数仅在对账时提供,28个字符内。 total_fee必填订单总金额，以分为单位fee_type必填现金支付币种attach必填渠道数据包，原样返回pay_channel必填支付渠道 ZFB:支付宝CFT：财付通WY：网银YL：银联sign必填MD5签名结果4 签名规则sign=md5(cmdno=1&pay_result=0&date=20051220&transaction_id=1000000301200512200000000004& ec_orderno =k0000000001&total_fee=100& fee_type=1&attach=test_attach& pay_channel =CFT&key=1000000301)注意：以上拼凑值不要有空格！使用标准MD5算法对该字符串进行加密，加密结果全部转换成大写后，即为我们所需的订单MD5 校验码第六章 枚举类型1 货币类型1 RMB 人民币2 - USD 美元3 - HKD 港币2 返回值编码pay_result返回值编码 ：0 成功3 自动补单机制POMP支持自动补单，补单通过重复请求网厅提供的回调页面（请求接口参数notice_url指定） 实现。网厅开发人