Migrate Subscriptions

Migrate Subscriptions to Another Plan

This endpoint allows you to migrate one or more subscriptions from an existing recurrence plan (from) to a new target plan (to). This is useful when updating the terms or pricing of an active subscription without interrupting service to the customer.

Usage Scenarios:
- Moving existing customers from a legacy plan to a newly structured or updated plan.
- Updating subscription pricing or billing frequency while preserving active subscriptions.
- Consolidating subscriptions under a single plan for easier management.

Notes:
- Both from and to plan IDs must be valid UUIDs and belong to the same seller.
- If the subscriptions list is not provided, all subscriptions linked to the source plan (from) will be migrated to the destination plan (to).
- The username header should be provided for audit and traceability purposes.
- Ensure that the destination plan has compatible settings to avoid issues during migration.

请求参数

Authorization

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api.pre.globalgetnet.com/authentication/oauth2/access_token

OAuth 2.0

Client Credentials

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Token URL: https://api-sbx.globalgetnet.com/authentication/oauth2/access_token

Scopes:

digital-platform:gateway-api-Read and write access

Header 参数

Body 参数application/json必填

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

application/json

Accepted

Bodyapplication/json

示例

{
    "from": "dee192b0-275e-44a2-9c77-32b75da2f26f",
    "to": "4a3e8739-e3a9-4b51-9b6f-406b6818a828",
    "subscriptions": [
        "497f6eca-6276-4993-bfeb-53cbbbba6f08"
    ]
}

请求参数

请求示例代码

返回响应