创建店铺与 AppAuth

注意

本页适用于 OpenAPI 自主接入，或平台能力声明明确要求补充此能力的场景。使用平台集成方案时，请先确认该方案的 OpenAPI 依赖和职责边界。

接口名：/go/packageOpenApiWeb/OpenApiV2/OpenApiCreateUserAndShopV2

这是面向特殊接入场景的定制化接口，用于由电商 SaaS 平台创建 Xcotton 用户和店铺，不是通用商户接入接口。仅事先完成配置的平台类 App（appType==1）可用；接入前请与 Support 确认权限和参数约定。

Xcotton 会提供一个平台专用 app，用于 申请令牌。得到的 token 只能调用本接口，不能当店铺 token 去调投保、发货、退保等商户业务接口。

请求头必须同时包含 Authorization: Bearer {平台token} 和 Signature（规则见 鉴权）。本接口不读取店铺级签名开关，Signature 始终必填，应使用平台 SaaS App 已配置的签名密钥计算。

调用本接口创建店铺后，店铺会有专属 App；再申请令牌可得到店铺范围 token，用于投保、发货、取消投保等接口。

完整字段说明见 API 接口文档 · OpenApiCreateUserAndShopV2。

注意：

• 出参类型是 CreateShopRespDataV2：appId / secret / uid / shopId / authId。
• sellerDomain 选填；未传时可从 domain 推导。
• 请求体中的 signKey 是新店铺后续调用商户 OpenAPI 时使用的签名密钥，与本次请求头 Signature 所用的平台 App 密钥不是同一个字段。signKey 可传空字符串或省略；为空时服务端自动生成并保存。

接口入参示例：

{
    "shopName": "testshop-2025072103",
    "email": "onboarding@example.com",
    "domain": "https://shop.example.com",
    "platForm": "PlatFormUeeShop",
    "signKey": ""
}

接口出参示例：

{
    "errCode": 0,
    "errMsg": "success",
    "data": {
        "appId": 1000199,
        "secret": "example-app-secret",
        "uid": 177249120,
        "shopId": 116816,
        "authId": 22296
    }
}