PHP银联在线支付接口开发日志

最新推荐文章于 2025-07-06 14:00:00 发布

醒来终觉梦

最新推荐文章于 2025-07-06 14:00:00 发布

阅读量8.4k

点赞数 6

CC 4.0 BY-SA版权

分类专栏： PHP开发文章标签： php 银联支付 wap

本文链接：https://blog.youkuaiyun.com/qq_29422633/article/details/53673198

本文记录了PHP开发银联在线支付接口的过程，包括登录银联测试平台，下载并配置测试及生产环境的证书，以及在TP3.2框架中进行代码测试和环境切换的注意事项。开发者需确保PHP环境支持curl和openssl，遵循官方文档进行操作。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

银联在线支付接口开发日志

1、登录银联自助化测试平台（登陆地址：open.unionpay.com），登录后，点击我的产品，如下：点击右方需要测试的接口，本例以手机网页支付（WAP支付）为例。

这里写图片描述

2、点击左侧菜单测试参数，即可看到测试过程所需要的参数，如下图：点击测试证书，下载两个证书，一个是以后缀 .pfx 的私钥证书，一个是后缀 .cer 的公钥证书，将其下载后，私钥证书文件名称修改为 acp_test_sign.pfx 。或者你不下载的话，直接用本例子的也可以。TP3.2例子里面 Public/cer 里面已有所有证书文件。
这里写图片描述

3、 TP3.2例子里面已有相关代码可以用来测试，测试的时候请使用测试环境的参数，代码中均有注释。在开始之前要确保你的环境PHP版本基于5.3，需开启curl、openssl功能，还有测试要放在线上测试，本地的虚拟域名是不行的。如遇到什么问题，可以参考官方的说明，本文件夹里面有个 PHP Version SDK 是官方的文档，参考里面的说明就好了，他们那个例子我测试的时候也跑不起来，不知道什么鬼原因。
4、切换到生产环境，注意以下问题：
4.1 首先根据你收到的商户开通邮件里面的指示，访问网站 http://cs.cfca.com.cn/
下载生产证书文件：
这里写图片描述
点击下载后，完成下载操作后，页面会出现下载成功的提示。下载的证书自动存放在IE中，下一步就要进行证书的导出。

4.2 导出证书文件：打开IE浏览器，点击右上角的齿轮，打开工具=》Internet选项=》内容=》证书，如图：
这里写图片描述

点击证书后，找到刚刚下载的那个证书，你可以根据名称去辨别，商户邮件中有标注：
这里写图片描述
上图中红色标注的名称应该跟你下载的那个名称一样。

找到它，然后点击导出：一路的下一步，在以下几步需要注意

这里写图片描述

以上密码就是 config.php 里面生产环境要设置的那个密码，请设置为六位数字（仅限数字，请勿设置字母及符号）

指定导出证书的文件名，名称就设置为：acp_prod_sign，并选择目录存放证书，点击下一步，设置导出到桌面，完成后将在桌面看到一个 acp_prod_sign.pfx 的文件。这个就是生产环境要用到的私钥文件，将它复制一份到证书目录 /Public/cer 。下一步就要上传这个证书到商户服务网站。

4.2 上传证书到商户服务网站。登录 https://merchant.unionpay.com/portal/login.jsp
这里写图片描述
上传刚刚导出的那个 acp_prod_sign.pfx 文件，点击上传。

下一步，启用证书，点击安全证书管理，启用即可。
这里写图片描述

下一步，下载银联公钥
这里写图片描述
解压文件，把里面的两个证书同样放到 /Public/cer 里面。然后就去 config.php 里面根据文件注释切换到生产环境即可。

这里写图片描述

以下是TP3.2的代码资料：
/App/Home/Conf/config.php

<?php
return array(
    //'配置项'=>'配置值'

    'UNIONPAY' => array(// 银联配置
                //测试环境参数
                'frontUrl' => 'https://101.231.204.80:5000/gateway/api/frontTransReq.do', //测试环境前台交易请求地址
                //'frontUrl' => 'https://gateway.95516.com/gateway/api/frontTransReq.do', //生产环境前台交易请求地址

                'singleQueryUrl' => 'https://101.231.204.80:5000/gateway/api/backTransReq.do', //测试环境单笔查询请求地址
                //'singleQueryUrl' => 'https://gateway.95516.com/gateway/api/queryTrans.do', //生产环境单笔查询请求地址

                'signCertPath' =>getcwd().'/Public/cer/acp_test_sign.pfx', //签名证书路径 这个证书就是你在https://open.unionpay.com/ajweb/account/testPara 上面下载的那个商户私钥证书 供你测试使用 
                //'signCertPath' =>getcwd().'/Public/cer/acp_prod_sign.pfx', //签名证书路径 这个证书就是你在 商户开通邮件里面叫你去 http://cs.cfca.com.cn/ 下载并把私钥上传至商户服务网站并启用的那个私钥文件

                'signCertPwd' => '000000', //测试环境签名证书密码
                //'signCertPwd' => '135246', //生产环境证书签名证书密码 这个密码是你在IE导出上述私钥文件时候你自己定义的6位数字密码 

                //'verifyCertPath' => getcwd().'/Public/cer/verify_sign_acp.cer', //测试环境验签证书路径
                'verifyCertPath' => getcwd().'/Public/cer/acp_prod_verify_sign.cer', //验签证书路径

                'merId' => '777290058138754', //测试商户代码
                //'merId' => '8024400481****', //生产环境商户代码 从你的商户开通邮件里面有


        ),
        'UNIONPAY_CONFIG'=>array(// 银联配置
                'version' => '5.0.0', //版本号
                'encoding' => 'GBK', //编码方式
                'signMethod' => '01', //签名方式
                'txnType' => '01', //交易类型
                'txnSubType' => '01', //交易子类
                'bizType' => '000201', //产品类型
                'channelType' => '07',//渠道类型
                'frontUrl' => "http://win2.qbt8.com/ase_admin/index.php/Home/ypay/pay_success", //前台通知地址
                'backUrl' => "http://win2.qbt8.com/ase_admin/index.php/Home/ypay/notify", //后台通知地址
                'frontFailUrl' => "http://win2.qbt8.com/ase_admin/index.php/Home/ypay/pay_fail", //失败交易前台跳转地址
                'accessType' =>