快速集成指南

本章节展示了如何从零开始，快速接入PayCloud支付网关。

第一步：商户注册

首先联系你的销售人员申请注册PayCloud商户。你需要提前准备商户/门店相关的材料信息，以及你的联系方式。一旦商户申请成功，你可以获得以下信息：

• 商户号(Merchant Number): 商户身份的唯一标识，交易请求中均需要上送标识
• 门店号(Store Number): 门店是商户线下交易发生的实际地点，划分了经营数据的可见范围
• 终端序列号(Terminal SN): 支付专用终端归属于一个线下门店，SN(序列号)是终端的唯一标识
• 商户平台登录账号(Login Account): 使用账号登录商户平台,可以管理支付应用及查询交易,商户平台登录账号和登录地址请联系您的销售人员。

第二步：创建支付应用

使用上一步获得的商户平台账号登录，进入 "开发设置 > 基础设置"，创建一个新应用，可获得应用的AppID。

第三步：配置应用密钥

PayCloud网关的安全策略要求使用RSA非对称加密算法对数据报文进行签名，保证交易双方的真实性和数据的完整性，防止通讯过程中数据被非法篡改。

• 关于RSA非对称加密机制，要求开发者的第三方应用与PayCloud网关各自生成一套密钥（公钥和私钥），双方互相交换公钥，而私钥则自行保证安全管理。
• 公钥交换：开发者可通过商户平台查看PayCloud网关的公钥(gateway_rsa_public_key)，并上传应用公钥(app_rsa_public_key)。
• 通信过程中，发起方在请求报文中使用自己的私钥签名，接收方则使用对方的公钥验签；同理，响应过程也是如此。关于如何生成密钥和签名，请参考文档 密钥设置、签名与验签。

具体的界面操作过程如下：

1. 在应用列表中，在新建的应用行选择 "公钥管理"
2. 进入密钥配置界面，复制并粘贴应用公钥，点击OK保存

第四步：API授权

1. 首先根据你选择的支付集成方案，确定应用需要使用的API。详细参考：

   • 线上支付
     • Web收银台支付
       • PayCloud托管收银台
       • 商户托管收银台
   • 线下支付
     • 二维码支付
     • WiseCashier App 集成（云端模式）

2. 应用管理界面，选择对应的API进行授权

第五步：编写代码与集成测试

接下来你可以按照API文档的要求编写应用代码，并设定参数进行调试

• 阅读API规则
• 查看API详细文档

你也可以选择使用SDK快速集成（下载SDK或示例）

• SDK目前仅支持Java版本，但我们提供了一些常用语言的API调用示例(如:PHP和C#)
• 我们也提供Postman调试工具、密钥生成工具、签名验证工具，可通过GitHub下载。

我们推荐开发者使用SDK集成的方式，由于SDK封装了API请求的签名及API响应的验证逻辑，这将简化系统集成的工作。

如果您遇到任何问题，请联系技术支持团队，并提供您的订单号（merchant_order_no）或返回报文中的psn，以帮助我们快速定位问题原因。