集成概述

更新时间:

虚商是阿里云重要的渠道伙伴模式。阿里云提供集成能力,帮助虚商伙伴建设独立的云平台。本文介绍虚商伙伴平台与阿里云服务集成的前提、方案、流程、测试账号以及 API 参考。

image

集成前提

  • 建设自有平台。

  • 开通阿里云账号,详情请参见阿里云账号注册流程

  • 线上申请虚商伙伴业务。

  • 签订商务合同。

集成方案

虚商伙伴想要建设完整的云平台,需要将自有平台(包括客户管理、账单结算等模块)与阿里云产品相关的云账号管理,安全访问,云资源购买、开通及管理,账单,计量数据,备案,消息通知,工单升级等服务进行集成。该云平台支持虚商客户从注册到云资源购买、开通、管理、账务结算及查询、售后服务的完整消费周期。您也可根据实际情况选择仅集成阿里云账号管理、安全访问,实现客户从虚商平台注册后,免登录进入阿里云购买和管理资源。

虚商集成方案提供了阿里云资源的集成转售能力。虚商集成支持以下两种方案:

  • 服务化套件集成

    阿里云提供集成的服务化套件,将售卖、管理、备案、费用查询等功能集成到伙伴平台。该方案集成工作量小,提升了客户体验,您仅需关注客户管理和业务本身。

    服务化集成方案

  • API 集成

    基于产品封装、伙伴定价等需求,产品售卖页、备案服务可以通过集成云产品实例 API 来开发。由于控制台功能复杂,因此在 API 集成方案中仍建议采用服务化套件集成。

p68903

两种方案的区别在于售卖页、备案服务和费用中心环节的集成方式不同。服务化套件集成方案对售卖页、备案服务、和费用中心进行服务化集成,而 API 集成方案则需要调用阿里云提供的售卖相关 API 和备案服务相关 API,和订单/账单相关API开发集成。

服务化套件

阿里云把常用的页面模块化,对虚商伙伴输出了BUY页面和console页面,并且可以套用不同的云产品来使用。虚商伙伴只需通过iframe嵌入即可,底层调用的还是OpenAPI,此套方案可代替虚商伙伴完成模块开发。

服务化套件集成方案可以减少虚商伙伴的开发工作量,加速开发进度,因整个套件使用的商业标准与阿里云完全对齐,故不支持个性化配置。

imageOpenAPI集成

BUY页面,阿里云侧梳理商品的整个售卖生命周期,对应做了一套bss接口。所有接入的产品都通过统一的接口完成创建,升降变配,释放等事务。

CONSOLE页面,由于控制台业务逻辑过于复杂,开发成本巨大且得不偿失。建议不要尝试。

伙伴通过接口自研发自己的BUY&CONSOLE页面。

API集成的优缺点与服务化套件互补。

image

那么伙伴在集成过程中,需要结合自己的业务特性来选择,颗粒度到产品。如果没有特殊需求,建议使用服务化套件。

也可以在项目前期使用服务化套件,在开发完成后切换到自研buy页面。

特殊需求举例:

1.伙伴Portal有自营产品例如ECS,想要捆绑阿里云虚商渠道产品VPC,一起售卖给终端客户。这种情况服务化套件不支持这种个性化商业策略,只能走API方案实现。

2.伙伴想要对阿里云虚商渠道产品自定义配置价格。服务化套件的价格与官方对齐,不支持配置。只能走API方案实现。

说明

免登访问的有效时间周期为 1 小时。因此如果备案服务选择服务化集成,那么虚商客户需要在 1 小时内完成备案,否则会因为免登 Token 失效而导致备案失败。

集成流程

SDK参考请参见参考文档。

API 分类

参考文档

安全访问

Python 参考

实名认证

SDK 参考

预算管理

SDK 参考

备案服务

SDK 参考

Groovy 代码示例

工单服务

SDK 参考

虚商平台与阿里云集成流程如下图所示。单击图片中的集成步骤可以打开该步骤下调用相关 API 的调用场景或调用说明的文档,单击图片中 API 接口名称可打开对应的 API 参考文档。

虚商平台集成相关的 API 调用方式请参见请求结构公共参数签名机制

  • 账号 API 集成
    • CreateAgAccount
    • GetCustomerAccountInfo
    • GetCustomerList
  • 角色扮演及安全访问 API 集成
    • AssumeRole
    • GetSigninToken
    • Login
  • 实名认证 API 集成
    • GenerateAliyunBidCertWaysUrl
    • RemoveIdentityCertifiedForBidUser
    • QueryBidUserCertifiedInfo
  • 预算管理 API 集成
    • CreateResellerUserQuota
    • SetResellerUserQuota
    • QueryResellerAvailableQuota
    • ChangeResellerConsumeAmount
    • SetResellerUserStatus
    • SetResellerUserAlarmThreshold
  • 售卖页服务化集成或 API 集成
    • 查询产品信息 API
      • QueryProductList
      • DescribePricingModule
      • GetSubscriptionPrice
      • GetPayAsYouGoPrice
    • 除 ECS、RDS 外产品售卖页 API
      • CreateInstance
      • QueryAvailableInstances
      • ModifyInstance
      • RenewInstance
      • SetRenewal
      • ConvertChargeType
      • DescribeResourcePackageProduct
      • GetResourcePackagePrice
      • CreateResourcePackage
      • QueryResourcePackageInstances
      • RenewResourcePackage
      • UpgradeResourcePackage
    • ECS 售卖页 API
      • RunInstances
      • DescribeAvailableResource
      • Describeprice
      • DescribeInstances
      • ModifyInstanceSpec
      • ModifyPrepayInstanceSpec
      • ModifyInstanceNetworkSpec
      • RenewInstance
      • ReactivateInstances
      • DeleteInstance
      • PurchaseReservedInstancesOffering
      • DescribeReservedInstances
      • ModifyReservedInstances
    • RDS 售卖页 API
      • CreateDBInstance
      • RenewInstance
      • DeleteDBInstance
      • ModifyDBInstanceSpec
      • DescribeAvailableResource
      • CreateReadOnlyDBInstance
      • ModifyDBProxy
      • ModifyDBProxyInstance
      • CreateBackup
      • ModifyBackupPolicy
      • ModifySQLCollectorPolicy
      • CloneDBInstance
      • RestoreTable
      • RecoveryDBInstance
      • CreateDdrInstance
      • ModifyInstanceCrossBackupPolicy
  • 控制台服务化集成
    • 订单/账单 API 集成
      • QueryOrders
      • GetOrderDetail
      • CancelOrder
      • SubscribeBillToOSS
      • UnsubscribeBillToOSS
    • 备案服务化集成或 API 集成
      • ProductBindBsn
      • GetBsnSySn
      • GetBsnByResource
      • GrantBsnCode
  • 售后及其他 API 集成
    • 消息服务
      • ReceiveMessage
    • 工单服务(单击查看调用场景)
      • Add
      • QuestionReply
      • QuestionListNote
      • QuestionList
      • getOSSTempAuthor
      • getAttachTempURL

申请测试账号

在您正式开通售卖业务之前,可申请开通测试账号。

测试账号可用于测试以下服务:

  • 创建或查询客户账号

  • 实名认证

  • 安全访问

  • OpenAPI 调用

测试账号开通步骤:

  1. 注册阿里云账号,并完成实名认证。详情请参见阿里云账号注册流程企业实名认证

  2. 由阿里云正式员工为您申请测试账号。

说明
  • 测试账号在测试阶段结束后,可选做正式账号。

  • 测试账号有效期为 1 个月,一个测试账号最多可创建 20 个客户账号。

集成项目

伙伴完成了账号申请,虚商入驻申请,进入了虚商集成阶段。我们将分派虚商接口人帮助伙伴完成这一过程,直到项目上线和商业化。

过程中,还需要伙伴完成aps平台的集成流程和产品接入&调试。

Aliyun Partner Service 集成流程。

aps

Aliyun Partner Service 产品授权申请。APS产品申请界面