Marketplace:Marketplace Token Tracking Guide

Case Sensitivity Rules

3A. SaaS Products — SPI Delivery

When publishing your SaaS product, enable "Production API Notification" and configure your SPI callback URL. Select at least the createInstance event.

After a customer completes payment, the Marketplace sends an HTTP GET request to your callback URL:

GET https://your-domain.com/spi/callback?action=createInstance&aliUid=123456&orderBizId=xxx&productCode=abc123&...

Key parameters you need to capture and store:

Store the mapping orderBizId → (productCode, aliUid) in your database and associate it with the customer's account in your system.

Important: Your SPI endpoint must be idempotent (deduplicate on orderBizId) and respond within 3 seconds. The Marketplace retries up to 120 times on failure.

3B. SaaS Products — License Code Delivery

For license-code products, dynamic values are obtained via the DescribeLicense API instead of SPI callbacks.

When a customer activates their license, call:

DescribeLicense(LicenseCode = "<customer's license code>")

Extract the following from the response:

• License.ProductCode → used in moduleCode

• License.ExtendInfo.AliUid → used in accountId

Store these values and bind them to the customer's account for subsequent Bailian API calls.

3C. API Products — orderPay SPI

For API products, configure the Payment Success (orderPay) SPI callback in your ISV console. After a customer pays, the Marketplace pushes:

You must respond with {"success":true} and ensure idempotency based on requestId.

Critical mapping: orderBizId from the SPI callback is the same value as CaCloudMarketInstanceId that the API Gateway passes through to your backend. Configure your API Gateway to forward CaCloudMarketInstanceId as a backend header, then look up your mapping table to retrieve the corresponding productCode and aliUid.

Python (requests library)

import requests
import json

url = "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions"

headers = {
    "Authorization": "Bearer sk-xxx",
    "Content-Type": "application/json",
    "x-dashscope-euid": json.dumps({
        "bizType": "B2B",
        "moduleType": "Third-partyproducts",
        "moduleCode": "market_abc123",
        "accountType": "Aliyun",
        "accountId": "1234567890"
    })
}

payload = {
    "model": "qwen-plus",
    "messages": [
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello"}
    ]
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())

Python (OpenAI SDK)

from openai import OpenAI

client = OpenAI(
    api_key="sk-xxx",
    base_url="https://dashscope.aliyuncs.com/compatible-mode/v1",
    default_headers={
        "x-dashscope-euid": '{"bizType":"B2B","moduleType":"Third-partyproducts","moduleCode":"market_abc123","accountType":"Aliyun","accountId":"1234567890"}'
    }
)

response = client.chat.completions.create(
    model="qwen-plus",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello"}
    ]
)
print(response.choices[0].message.content)

Java (OkHttp)

import okhttp3.*;

public class BailianTrackingExample {

    public static void main(String[ ] args) throws Exception {

        OkHttpClient client = new OkHttpClient();

        String euidJson = "{\"bizType\":\"B2B\",\"moduleType\":\"Third-partyproducts\","
            + "\"moduleCode\":\"market_abc123\",\"accountType\":\"Aliyun\","
            + "\"accountId\":\"1234567890\"}";

        String body = "{\"model\":\"qwen-plus\",\"messages\":["
            + "{\"role\":\"user\",\"content\":\"Hello\"}]}";

        Request request = new Request.Builder()
            .url("https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions")
            .post(RequestBody.create(body, MediaType.parse("application/json")))
            .addHeader("Authorization", "Bearer sk-xxx")
            .addHeader("Content-Type", "application/json")
            .addHeader("x-dashscope-euid", euidJson)
            .build();

        Response response = client.newCall(request).execute();
        System.out.println(response.body().string());
    }
}

Node.js (fetch)

const response = await fetch(
  "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer sk-xxx",
      "Content-Type": "application/json",
      "x-dashscope-euid": JSON.stringify({
        bizType: "B2B",
        moduleType: "Third-partyproducts",
        moduleCode: "market_abc123",
        accountType: "Aliyun",
        accountId: "1234567890"
      })
    },
    body: JSON.stringify({
      model: "qwen-plus",
      messages: [
        { role: "user", content: "Hello" }
      ]
    })
  }
);
const data = await response.json();
console.log(data);

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    euid := map[string]string{
        "bizType":     "B2B",
        "moduleType":  "Third-partyproducts",
        "moduleCode":  "market_abc123",
        "accountType": "Aliyun",
        "accountId":   "1234567890",
    }
    euidBytes, _ := json.Marshal(euid)

    body := map[string]interface{}{
        "model": "qwen-plus",

        "messages": [ ]map[string]string{

            {"role": "user", "content": "Hello"},
        },
    }
    bodyBytes, _ := json.Marshal(body)

    req, _ := http.NewRequest("POST",
        "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
        bytes.NewBuffer(bodyBytes))
    req.Header.Set("Authorization", "Bearer sk-xxx")
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("x-dashscope-euid", string(euidBytes))

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var result map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&result)
    fmt.Println(result)
}

Dynamic Header Construction (Java / Spring)

For production use, you should dynamically assemble the header based on the current customer:

import org.springframework.http.*;
import org.springframework.web.client.RestTemplate;

public class BailianService {
    private final RestTemplate restTemplate = new RestTemplate();

    public String callModel(String productCode, String aliUid) {
        HttpHeaders headers = new HttpHeaders();
        headers.set("Authorization", "Bearer sk-xxx");
        headers.set("Content-Type", "application/json");

        String euid = String.format(
            "{\"bizType\":\"B2B\",\"moduleType\":\"Third-partyproducts\","
            + "\"moduleCode\":\"market_%s\",\"accountType\":\"Aliyun\","
            + "\"accountId\":\"%s\"}",
            productCode, aliUid
        );
        headers.set("x-dashscope-euid", euid);

        String body = "{\"model\":\"qwen-plus\",\"messages\":["
            + "{\"role\":\"user\",\"content\":\"Hello\"}]}";

        HttpEntity<String> entity = new HttpEntity<>(body, headers);
        ResponseEntity<String> response = restTemplate.postForEntity(
            "https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions",
            entity, String.class
        );
        return response.getBody();
    }
}

Marketplace — SPI Delivery (SaaS Products)

• Alibaba Cloud Marketplace production SPI

• Create an instance

• Instance expiration

• Renewal

• Release an instance

Marketplace — License Code Delivery (SaaS Products)

• DescribeLicense

• ActivateLicense

Marketplace — General

• Marketplace Documentation

• Vendor Guide

Model Studio (Bailian)

• Model Studio Documentation

• API Usage

• Text Generation