快速集成指南

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

第一步：注册商户

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

商户号(merchant_no/mid)：商户身份的唯一标识，交易请求中均需要上送此标识。
线下门店号(store_no/sid)：门店是商户线下交易发生的实际地点，划分了经营数据的可见范围，请求线下支付接口时需要上传此参数。
线上门店号(store_no/sid)：是用于标识商户在互联网平台上虚拟门店的唯一编号。它通常代表商户在某个线上交易场景中的经营单位，用于追踪线上交易活动、管理数据以及划分业务的可见范围，请求线上支付接口时需要上传此参数。
商户平台登录账号(Login Account)：使用账号登录商户平台，可以管理支付应用及查询交易，商户平台登录账号和登录地址请接收注册邮件通知或联系您的销售人员获得。

使用上一步获得的商户平台账号登录，进入 "开发设置 > 基础设置"，创建一个支付应用，可获得应用的 AppID。在所有的接口请求过程中，都需要传递应用ID。

解释

什么是AppID？为什么需要AppID？

AppID 是应用程序唯一标识符（Application Identifier）的缩写，用于唯一标识一个具体的应用程序或系统集成模块。它通常由开发平台或服务提供商分配，确保每个应用在系统中的身份是独特的，便于认证、权限管理和数据交互。

一个商户可以创建多个支付应用，但如果你是一个软件服务商（ISV），你需要为多个商户创建同一个应用，你可以联系您的支付服务商支持人员，创建新的应用或授权商户使用应用的权限。

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

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

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


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

根据你的业务场景，选择合适的支付产品

注意

我们的支付产品严格区分线上和线下业务，请选择正确的支付产品，否则将无法正常完成交易。请注意store_no参数，线下门店只能用于线下支付产品和接口，线上门店只能用于线上支付产品和接口。

特点	线下支付	线上支付
交易场景	面对面交易，通常发生在实体店或服务现场	通过网站、APP、小程序等互联网平台完成交易
支付方式	POS机刷卡支付、静态/动态二维码支付、NFC支付	网页支付、APP支付、小程序支付、H5支付
客户接触方式	客户需要亲自到店或与商户面对面完成支付	客户无需亲自到店，可远程完成支付
物流或交付	现场交付商品或完成服务	通常涉及物流配送或虚拟商品的电子交付
适用业务	餐饮、零售、美发美容等	电商、在线课程、订阅服务等
可选支付产品	- 扫码支付 - 手机网页支付	- 电脑网页支付 - 手机网页支付 - APP支付 - 小程序支付
特殊说明	微信支付、支付宝的手机网页支付只能从APP中打开，不能在浏览器中打开; 微信公众号支付即为此场景	微信支付、支付宝的手机网页支付只能从浏览器或通过摄像头扫码打开；微信支付将这个场景定义为H5支付，需要单独申请开通
参数要求	只能使用线下门店号（store_no/sid）	只能使用线上门店号（store_no/sid）
线上线下混合	实际业务中可能存在不严格区分线上线下业务的场景，比如： 1. 电脑网页支付时，将二维码(扫码支付-MPM模式)显示在网页上，完成线下转线上； 2. 从浏览器跳转到支付宝，通过线下手机网页支付唤起支付宝支付，实现线上业务的收款

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

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

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

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

小提示

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