金运通支付

Appearance

商户交易准备事项 ​

根据 SDK Demo下载 在本地开发完成支付功能开发（优先使用国密SM）。

商户测试数据 ​

支付功能开发完成后，在进行系统联调测试前准备事项（默认 - 测试环境的数据）：

公用商户 ​

  • RSA（国际）：290071040001
  • SM2（国密）：290054110015

公用证书 ​

网关密钥 ​

网关支付独有的签名密钥。注：网关支付与其他业务的加解密方式不同，它通过数字签名方式进行验证数据是否被串改。

  • SHA256：a1d3ab6f5994133c8383d433e7d9892b
  • SM3：95f0b27b18c04e6de94407ea412f8d0ee277ca9047e75b3d82b322ff6e3014bd

测试地址 ​

测试联调步骤 ​

有两种测试方式：
第一种公用数据测试：使用公用商户和公用证书（含网关密钥）测试联调交易
第二种入网数据测试：通过平台自助入网（测试地址），获得商户号及公私钥证书（含网关密钥）。

公用数据测试 ​

  • 步骤1：使用公用的商户号、平台公钥证书、商户私钥证书、交易测试地址，进行联调测试。
  • 步骤2：同【入网数据测试】的【步骤5、步骤6】一致。

入网数据测试 ​

注：① 入网邮箱必须是真实有效的；② 【产品证书类型】跟使用Demo加解密要一致

  • 步骤1：在平台自助入网（测试）进行入网申请，并提交申请记录。 alt text
  • 步骤2：入网申请提交后，等待金运通运营人员审核；可通过登录平台自助入网（测试），查看审核状态。 alt text
  • 步骤3：入网成功后，根据接收的邮件，登录商户服务平台：https://test.jytpay.com/JytMer/login.html ，配置交易参数：
    • ① 配置交易IP白名单：在 “用户管理 -> 商户参数配置” 菜单下配置；一般情况T+1天生效。（测试环境无需配置）
    • ② 配置回调通知地址：在 “用户管理 -> 商户参数配置” 菜单下配置；一般情况当天可生效。（注：如果交易有传通知地址，优先使用接口上传的）
    • ③ 公钥证书交换：商户通过证书工具生成一对公私钥，商户公钥给平台，平台把自己的公钥证书给商户。可在 “用户管理 -> 文件上传下载” 菜单下配置。
    • ④ 证书及其类型变更：在 “用户管理 -> 文件上传下载” 菜单下，选择使用的证书类型和对应证书类型的商户公钥，点击【上传】按钮。
    • ⑤ 证书变更后：在 “用户管理 -> 文件上传下载” 菜单下，下载对用的平台公钥证书。
    • ⑥ 证书生成工具：交易证书工具
  • 步骤4：使用入网商户号、平台公钥证书、商户私钥证书、交易测试地址，进行联调测试。
  • 步骤5：产品交易联调需要把交易（成功、失败、处理中）的情况都测试一遍。
  • 步骤6：联调结束后，进入上线准备阶段

上线准备阶段 ​

商户在测试联调成功后，系统上线前需要将测试联调阶段的所有准备事项中的数据更换成生产实际数据，具体包括请求地址、商户号以及非对称证书。注：请求地址、商户号在生产入网成功发的邮件里

申请生产商户 ​

交易证书工具 ​

  • 注：商户运行bat脚本后，将商户公钥文件在商户服务平台进行配置，商户私钥文件自行妥善保存，以免丢失和泄露。

  • RSA证书生成工具

md
1、下载RSA证书后，解压，并进入“genRsakey”文件夹下
2、执行“genRsakey.bat”脚本，生成公私钥证书
3、同脚本目录下生成公钥证书：rsa_public_key_2048.pem，私钥证书：rsa_private_key_2048.pem
4、登录商户服务平台，将上一步生成的商户国密公钥上传到金运通，并下载金运通平台国密公钥证书
md
1、下载SM2证书后，解压，并进入“./国密证书生成和转换/金运通国密证书工具”文件夹下
2、执行“create.bat”脚本，输入证书名称（mer_sm2），回车后开始生成公私钥证书
3、在“out”文件夹下产生国密公钥证书：*_public.pem，国密私钥证书：*_private.pem
4、登录商户服务平台，将上一步生成的商户国密公钥上传到金运通，并下载金运通平台国密公钥证书
注意：
如果是python、ruby、node语言（非此语言无需以下步骤），则需要将生成的国密公私钥做转换，步骤如下：
1、将金运通国密公钥证书和商户私钥证书复制到文件夹：“./国密证书生成和转换/国密证书转换成HEX/pem”下
2、返回到“国密证书转换成HEX”文件夹下，执行“JytConvertHex.bat”脚本
3、若证书在pem目录下，且证书命名：金运通公钥jyt_sm2_public.pem、商户私钥mer_sm2_private.pem，则一直按回车键即可
4、若证书名命名非上一步规则，则手工输入“路径+名称”
5、执行成功后，在“./国密证书生成和转换/国密证书转换成HEX/out”文件夹下，生成了python、ruby、node语言可用的国密证书

配置交易参数 ​

  • 商户服务平台：https://mg.jytpay.com/JytMer/login.html
  • 商户入网成功后，会发送邮件初始登录信息，然后登录商户服务平台，进行生产参数配置
    • ① 配置交易IP白名单：在 “用户管理 -> 商户参数配置” 菜单下配置；一般情况T+1天生效。
    • ② 配置回调地址：在 “用户管理 -> 商户参数配置” 菜单下配置；一般情况当天可生效。
    • ③ 公钥证书交换：商户通过证书工具生成一对公私钥，商户公钥给平台，平台把自己的公钥证书给商户。可在 “用户管理 -> 文件上传下载” 菜单下配置。
    • ④ 证书及其类型变更：在 “用户管理 -> 文件上传下载” 菜单下，选择使用的证书类型和对应证书类型的商户公钥，点击【上传】按钮。
    • ⑤ 证书变更后：在 “用户管理 -> 文件上传下载” 菜单下，下载对用的平台公钥证书。