ISV服务商接入

1. ISV是什么

ISV全称为"Independent Service Provider"，在PayerMax内部，推荐自身拥有子商户资源的支付机构或SaaS服务商以ISV的身份接入。ISV与PayerMax完成系统集成后，可以代子商户发起交易请求。

2. 适用场景

ISV本身可以是拥有支付牌照的机构，也可以是SaaS服务提供商，在采用ISV模式与PayerMax对接之前，请先联系对接商务确认业务场景和用户流程是否合适。

3. 流程和角色关系

%%{init: {
  'theme': 'base',
  'themeVariables': {
    'primaryColor': '#e6f0ff',
    'primaryTextColor': '#333',
    'primaryBorderColor': '#5b9bd5',
    'lineColor': '#888',
    'actorMargin': 40,
    'noteBkgColor': '#0056b3',
    'noteTextColor': '#ffffff',
    'noteBorderColor': '#004a99'
  }
}}%%
sequenceDiagram
    participant User as C端用户
    participant SubMerchant as 子商户
    participant ISVMerechant as ISV商户
    participant PM as PayerMax

    %% 业务集成阶段
    SubMerchant->>ISVMerechant: 1. 业务关联
    ISVMerechant->>PM: 2. 系统集成支付服务
    PM-->>SubMerchant: 3. 提供支付服务

    %% 支付发起阶段
    User->>SubMerchant: 4. 发起支付
    SubMerchant->>ISVMerechant: 5. 请求支付
    ISVMerechant->>PM: 6. 发起支付

4. 支持集成模式

通过ISV模式接入PayerMax的商户，在支持的集成模式上与普通商户无区别，即支持收银台支付、纯API支付、前置组件、链接支付、Tokenization支付。

5. 接口参数

在ISV模式下，ISV作为集成方需要关注几个核心参数：

• spMerchantNo：指ISV商户自身的商户号，在以ISV身份入驻PayerMax时由PayerMax分配。

• merchantNo：指子商户的商户号。子商户一般也需要在PayerMax入驻，入驻时由PayerMax分配，并提供给ISV商户在每次发起交易时传入。

• appId：代表的是系统集成方的应用，密钥与appId绑定。 对于ISV服务商，系统集成由ISV服务商来集成，所以交易接口中的appId上送的是ISV服务商的appId。

• Auth Token：当ISV商户和其子商户分别在PayerMax完成入驻后，PayerMax会基于二者的绑定关系生成Auth Token。如果一个ISV存在多个子商户，则PayerMax会分配多个Auth Token区分来自不同子商户的交易。 ISV服务商在代子商户请求交易时，在HTTP Header中上送merchant_auth_token=授权分配的Auth Token。

%%{init: {'theme': 'base', 'themeVariables': { 'primaryTextColor': '#fff', 'edgeLabelBackground':'#ffffff00'}}}%%
graph LR
    %% 定义一个样式类
    classDef myStyle fill:#0056b3,stroke:#004085,stroke-width:1px,color:#fff,font-weight:bold;

    %% --- 这里是修改点 ---
    %% A( ) 表示圆角矩形
    A(ISV服务商：
spMerchantNo, appid)
    %% -------------------
    
    %% 使用子图，将子商户锁定在同一垂直列，确保平行
    subgraph SubMerchants [" "]
        %% 子商户使用 ( ) 圆角矩形
        B("子商户01:
MerchantNo, merchant_auth_token_01")
        C("子商户02:
MerchantNo, merchant_auth_token_02")
        D("子商户03:
MerchantNo, merchant_auth_token_03")
    end

    %% 连接
    A --- B
    A --- C
    A --- D

    %% 应用样式
    class A,B,C,D myStyle;

    %% 隐藏子图的边框
    style SubMerchants fill:none,stroke:none;

6. 传参指引

请求Header：传入merchant_auth_token ，示例如下：

"headers": {
	"Accept": "application/json",
	"merchant_auth_token": "2024071***73504",//必须
	"sign": "请参考签名规则：https://docs-v2.payermax.com/doc-center/developer/config-settings.html",//必须
	"Content-Type": "application/json"
}

请求Body：示例如下，详细的接口文档请参阅收银台-下单接口。

注意：

接口中没有spMerchantNo，请参考下面Body。

{
	"requestTime": "2024-08-12T14:59:53.279+08:00",
	"version": "1.1",
	"appId": "需要替换为ISV服务商的appid",
	"merchantNo": "需要替换为子商户号",
	"spMerchantNo": "需要替换为ISV服务商商户号",
	"keyVersion": "1",
	"data": {
		"outTradeNo": "20240812025xxxx",
		"userId": "704138842",
		"subject": "商品描述",
		"totalAmount": 700,
		"country": "KR",
		"currency": "KRW",
		"language": "en",
		"frontCallbackURL": "https://www.baidu.com",
		"notifyUrl": "https://www.baidu.com"
	}
}

参数	类型	是否必填	最大长度	描述	示例值
version	String	M	8	接口版本。当前值为：1.1	1.1
keyVersion	String	M	8	密钥版本。当前值为：1
requestTime	String	M	32	请求时间，符合rfc3339规范，格式：yyyy-MM-dd'T'HH:mm:ss.SSSXXX	2022-01-22T10:00:00.500+08:00
appId	String	M	64	集成方的集成App Id	46153e2b787241ae8b01857bb087d1bd
spMerchantNo	String	M	15	ISV服务商的商户号
merchantNo	String	M	15	商户号，商户与PayerMax业务签约时生成的唯一标识	010229810189301
+data	Object			请参见各业务接口下的具体字段
「+......