─────────────────────────────────────────     
产品名称： 控件支付产品
修改日期：  2015-12-06
─────────────────────────────────────────

───────────
 **重要**
1） 联调前请仔细阅读以下说明。
2） 本示例PHP版本基于5.3，需开启curl、openssl功能。
3） 此工程可以跑起来测试，建议使用chrome、firefox打开。
  全渠道PC网关/WAP支付产品消费交易示例地址为：http://IP：端口/upacp_demo_app/index_05_app.php
───────────

───────────
示例工程目录结构
───────────

upacp_sdk_php
  │
  ├assets ┈┈┈┈┈┈┈┈┈相关资源目录
  │  │  
  │  ├windows开启openssl所需dll文件┈┈┈┈┈windows环境php开启openssl功能所需dll文件
  │  │  
  │  ├测试环境证书
  │  │  │  
  │  │  ├acp_test_sign.pfx┈┈┈┈┈┈┈┈┈ ***重要*** 测试环境签名私钥证书（所有商户固定使用同一个）
  │  │  │  
  │  │  └acp_test_verify_sign.cer ┈┈┈┈┈┈┈┈┈***重要*** 测试环境验签公钥证书（所有商户固定使用同一个）  
  │  │  
  │  ├生产环境证书
  │  │  │
  │  │  └acp_prod_verify_sign.cer ┈┈┈┈┈┈┈┈┈***重要*** 生产环境验签公钥证书（所有商户固定使用同一个）
  │  │  
  │  ├生产环境配置文件
  │  │  │
  │  │  └SDKConfig.php┈┈┈┈┈┈┈┈┈生产环境配置文件样例（使用的时候修改里边证书路径并替换掉utf8/func下的测试环境配置文件SDKConfig.php）
  │  │ 
  │  └对账文件样例 
  │     │
  │     └802310048993424_20150905.zip┈┈┈┈┈┈┈┈┈提供的对账文件样例（如果需要可以参考）
  │  
  ├demo ┈┈┈┈┈┈┈┈┈ 示例代码
  │  │  
  │  ├api_05_app ┈┈┈┈┈┈┈┈┈ 网关产品
  │  │  │  
  │  │  ├Form_6_2_AppConsume.php┈┈┈┈┈消费获取tn示例类（后台）
  │  │  │  
  │  │  ├Form_6_3_ConsumeUndo.php┈┈┈┈┈消费撤销交易示例类 （后台）
  │  │  │  
  │  │  ├Form_6_4_Refund.php┈┈┈┈┈退货交易示例类 （后台）
  │  │  │  
  │  │  ├Form_6_5_Query.php┈┈┈┈┈交易状态查询示例类 （后台）
  │  │  │  
  │  │  ├Form_6_6_FileTransfer.php┈┈┈┈┈对账文件下载示例类 （后台）  
  │  │  │  
  │  │  ├Form_6_7_1_FrontPreauth.php┈┈┈┈┈ 预授权获取tn示例类（后台）
  │  │  │  
  │  │  ├Form_6_7_2_PreauthUndo.php┈┈┈┈┈预授权撤销交易示例类 （后台）
  │  │  │  
  │  │  ├Form_6_7_3_PreauthFinish.php┈┈┈┈┈预授权完成交易示例类 （后台）
  │  │  │  
  │  │  └Form_6_7_4_PreauthFinishUndo.php┈┈┈┈┈预授权完成撤销交易示例类 （后台）
  │  │   
  │  ├FrontReceive.php┈┈┈┈┈前台通知处理示例类 （后台） 
  │  │
  │  └BackReceive.php┈┈┈┈┈后台通知处理示例类 
  │  
  ├utf8.func┈┈┈┈┈┈sdk以及配置文件
  │  │
  │  ├acp_service.php┈┈┈┈┈┈sdk主要使用的文件  
  │  │  
  │  ├common.php┈┈┈┈┈┈方法类文件
  │  │
  │  ├log.class.php┈┈┈┈┈日志工具类
  │  │
  │  ├SDKConfig.php┈┈┈┈┈┈┈【【【重要】】】测试环境配置文件，需配置请求银联地址，私钥签名证书，验签公钥路径
  │  │    
  │  └SecureUtil.php┈┈┈┈┈┈┈安全相关工具类
  │  
  ├pages ┈┈┈┈┈┈┈┈┈ demo演示相关页面，内容不重要，未列举
  │
  ├static ┈┈┈┈demo演示相关js和css，内容不重要，未列举
  │
  ├index_05_app.php ┈┈┈┈demo演示入口页面
  │
  └readme.txt ┈┈┈┈┈┈┈┈┈使用说明文本

───────────
**注意**

1.【关于商户号】开发包中使用的商户号777290058110097是open.unionpay.com注册的测试商户号，只能在入网测试环境使用；
      可以先使用这个商户调通交易(当然您也可以自己在这个网站注册一个777开头的测试商户号，自己注册后要开通权限：https://open.unionpay.com 登陆后 右上角我的测试-我的产品-将未测试的产品点击成测试状态，过10分钟后就有权限了）
      正式线上环境请替换成申请的正式商户号，并确保商户号有对应的权限，如果报了无此交易权限等错误，请联系您申请接入银联的业务人员确认您做的交易是否开通了对应的权限。
  
2.【关于证书文件】测试环境使用的签名私钥证书，验签公钥证书均在assets目录下找得到，使用的时候只需要配置到utf8/func/SDKConfig.php指定的目录下即可，使用我们的demo不需要了解签名，验签等算法，详细参考配置文件注释。
                                      生产环境使用的验签公钥证书，生产环境的SDKConfig.php文件在assets提供了，只需要配置上私钥和公钥即可，详细参考配置文件注释。

3.测试过程中的如果遇到疑问或问题您可以：
  1）优先在open平台中查找答案：
  	 调试过程中的问题或其他问题请在 https://open.unionpay.com/ajweb/help/faq/list 帮助中心 FAQ 搜索解决方案
             测试过程中产生的6位应答码问题疑问请在https://open.unionpay.com/ajweb/help/respCode/respCodeList 输入应答码搜索解决方案
  2）咨询【测试环境】在线人工支持： open.unionpay.com注册一个用户并登陆在右上角点击“在线客服”，咨询人工QQ测试支持,咨询的时候需把 请求报文，请求银联地址，报错描述 贴给支持人员以方便查问题。
  3）测试环境测试支付请使用测试卡号测试， FAQ搜索“测试卡号”。
  4）切换生产环境要点请FAQ搜索“切换”。
  
4.【生产环境问题】连接银联生产环境测试遇到的问题 如果通过open平台无法解决 请登陆merchant.unionpay.com 菜单"服务单管理"->"创建服务单"请求排查问题。

5. 为方便查看代码没正确执行的原因，测试时请务必打开php.ini的display_errors，正式使用时再设置Off。

───────────

