久而旧之

对接银联支付开发文档

2017-12-25

对接银联支付开发文档

1、证书下载、导出及上传流程

  • 在申请完成银联入网后,邮件会收到[商户入网参数信息通知(请注意保密)标识的一封邮件]
  • 商户服务网站[ 商户服务网站 ]
  • 参考邮件里面的用户名、初始密码[111111] 进行登录商户
  • 证书下载[IE浏览器]
  • cfca下载证书网站[ cfca ]
  • 下载证书需要邮件里面的 证书参考号、证书授权码
  • 然后通过邮件附件中的(证书下载、导出及上传流程.docx)文档操作流程
  • 导出证书需要选择保存位置 证书名称无限制

2、开发包下载及对接

下载:[ 开发包地址 ]
下载后可以看到开发demo 以下例子version=5.1版本[b2c网关支付=000201]

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
upacp_demo_b2c

├assets ┈┈┈┈┈┈┈┈┈相关资源目录
│ │
│ ├windows开启openssl所需dll文件┈┈┈┈┈windows环境php开启openssl功能所需dll文件
│ │
│ ├机构接入需做改动┈┈┈┈┈┈┈┈┈收单机构接入需要做的改动
│ │
│ ├测试环境证书
│ │ │
│ │ ├acp_test_enc.cer┈┈┈┈┈┈┈┈┈ 【重要】测试环境敏感信息加密证书(所有商户固定使用同一个)
│ │ │
│ │ ├acp_test_sign.pfx ┈┈┈┈┈┈┈┈┈ 【重要】 测试环境签名私钥证书(所有商户固定使用同一个)
│ │ │
│ │ ├acp_test_root.cer ┈┈┈┈┈┈┈┈┈ 【重要】 测试环境验签公钥证书根证书 (所有商户固定使用同一个)
│ │ │
│ │ └acp_test_middle.cer ┈┈┈┈┈┈┈┈┈【重要】 测试环境验签公钥证书中级证书 (所有商户固定使用同一个)
│ │
│ ├生产环境证书
│ │ │
│ │ ├acp_prod_enc.cer┈┈┈┈┈┈┈┈┈【重要】 生产环境敏感信息加密证书(所有商户固定使用同一个)
│ │ │
│ │ ├acp_prod_root.cer ┈┈┈┈┈┈┈┈┈【重要】 生产环境验签公钥根证书 (所有商户固定使用同一个)
│ │ │
│ │ └acp_prod_middle.cer ┈┈┈┈┈┈┈┈┈【重要】 生产环境验签公钥中级证书 (所有商户固定使用同一个)
│ │
│ ├生产环境配置文件
│ │ │
│ │ ├acp_sdk.ini.密钥 ┈┈┈┈┈┈┈┈┈ 【重要】 生产环境配置文件样例(密钥方式签名)(使用方式请看文件里的说明)
│ │ │
│ │ └acp_sdk.ini.证书 ┈┈┈┈┈┈┈┈┈ 【重要】 生产环境配置文件样例(证书方式签名)(使用方式请看文件里的说明)
│ │
│ ├测试环境配置文件
│ │ │
│ │ ├acp_sdk.ini.密钥 ┈┈┈┈┈┈┈┈┈ 【重要】 测试环境配置文件样例(密钥方式签名)(使用方式请看文件里的说明)
│ │ │
│ │ └acp_sdk.ini.证书 ┈┈┈┈┈┈┈┈┈ 【重要】 测试环境配置文件样例(证书方式签名)(使用方式请看文件里的说明)
│ │
│ └对账文件样例
│ │
│ └802310048993424_20150905.zip┈┈┈┈┈┈┈┈┈提供的对账文件样例(如果需要可以参考)

├demo ┈┈┈┈┈┈┈┈┈ 示例代码
│ │
│ ├api_01_gateway ┈┈┈┈┈┈┈┈┈ 网关产品
│ │ │
│ │ ├BackReceive.php┈┈┈┈┈后台通知处理示例类
│ │ │
│ │ ├FrontReceive.php┈┈┈┈┈前台通知处理示例类
│ │ │
│ │ ├EncryptCerUpdateQuery.php ┈┈┈┈┈加密证书更新示例类(后台)
│ │ │
│ │ ├Form_6_2_FrontConsume.php┈┈┈┈┈前台跳转银联支付页面示例类(前台)
│ │ │
│ │ ├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┈┈┈┈┈前台跳转银联预授权页面示例类(前台)
│ │ │
│ │ ├Form_6_7_2_PreauthUndo.php┈┈┈┈┈预授权撤销交易示例类 (后台)
│ │ │
│ │ ├Form_6_7_3_PreauthFinish.php┈┈┈┈┈预授权完成交易示例类 (后台)
│ │ │
│ │ └Form_6_7_4_PreauthFinishUndo.php┈┈┈┈┈预授权完成撤销交易示例类 (后台)
│ │
│ ├getdir.php ┈┈┈┈┈获取服务器绝对路径
│ │
│ ├multiCertDemo.php ┈┈┈┈┈多证书demo(证书方式)
│ │
│ └multiKeyDemo.php ┈┈┈┈┈多证书demo(秘钥方式)

├sdk┈┈┈┈┈┈sdk,除了acp_service外的类为内部使用,不用看,acp_sdk.ini为配置文件
│ │
│ ├acp_sdk.ini ┈┈┈┈ 配置文件,默认取了“assets/测试环境配置文件”文件夹下的证书方式签名配置文件。
│ │
│ └acp_service.php ┈┈┈┈┈┈ 全渠道 SDK API类

├pages ┈┈┈┈┈┈┈┈┈ demo演示相关页面,内容不重要,未列举

├static ┈┈┈┈ demo演示相关js和css,内容不重要,未列举

└index_01_gateway.php ┈┈┈┈demo演示入口页面

───────────
  • 测试环境下

注:每个开发包里面都会有测试正式、生产环境证书;
在测试环境下 我们首先配置sdk/aco_sdk.ini 配置证书及前后台地址,运行demo 然后若是可以跳转到支付页面,说明正常。

  • 生产环境下

注:每个开发包里面都会有测试正式、生产环境证书;
在生产环境下 我们首先配置sdk/aco_sdk.ini 配置证书及前后台地址,对接银联 然后若是可以跳转到支付页面,说明正常。

  • 注意
    在对接支付需要注意支付金额为分 无小数点
    在对接过程最好按照demo里的把log日志配置完成 方便技术debug
    在Linux 环境下 证书需要配置绝对路径且证书路径有可读权限
    在[IE]浏览器会下载一个商户专属证书[公钥、私钥]公钥上传到商户并开启,私钥在程序里面使用
    在程序里面共有4个证书acp_prod_enc.cer[加密证书]、acp_prod_root.cer[根证书]、acp_prod_middle.cer[中级证书]、acp_prod_sign.pfx[cfca私钥证书]
    若生产环境下出现防钓鱼,请联系银联收单机构进行去掉或者加上自己的域名地址或IP地址
    在生产环境下若有对接支付问题 可联系银联QQ[800033969] 固话[021-38929999转2049]

  • Notice

如若需要,请戳 [ About ] 下联系我 欢迎联系.ok,enjoy it !

使用支付宝打赏
使用微信打赏

欢迎点击上方按钮对我打赏,谢谢你给我吃糖果