Skip to main content
POST
/
mcp
/
change_subscription
curl --request POST \
  --url https://api.splitz.co.il/mcp/change_subscription \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "subscription_uid": "sub_1234567890abcdef",
  "target_product_uid": "prod_premium_monthly",
  "return_url": "https://example.com/subscription-upgraded"
}
'
{
  "success": true,
  "data": {
    "request_uid": "pcr_abcdef1234567890",
    "approval_url": "https://app.splitz.co.il/change-plan-approval/pcr_abcdef1234567890/token123",
    "expires_at": "2025-11-04T12:00:00.000Z",
    "requires_payment": true,
    "prorated_amount": 15.5,
    "current_product": {
      "name": "תוכנית בסיסית חודשית",
      "price": 29.9
    },
    "target_product": {
      "name": "תוכנית פרימיום חודשית",
      "price": 59.9
    }
  }
}

Authorizations

​
Authorization
string
header
required

אימות באמצעות Bearer Token. יש לשלוח כותרת Authorization עם הערך Bearer <SHOP_API_KEY>.

דוגמה:

Authorization: Bearer sk_live_1234567890abcdef

המפתח הוא מפתח ה-API של החנות (Shop Model: api_key) שניתן למצוא בפאנל הניהול של Splitz.

Body

application/json

פרטי בקשת שינוי התוכנית

​
subscription_uid
string
required

מזהה ייחודי של המנוי שברצונך לשנות

Minimum string length: 1
Example:

"sub_1234567890abcdef"

​
target_product_uid
string
required

מזהה ייחודי של המוצר/תוכנית החדשה אליה רוצים לעבור. המוצר חייב להיות שייך לאותה חנות ולהיות שונה מהמוצר הנוכחי.

Minimum string length: 1
Example:

"prod_premium_monthly"

​
return_url
string<uri>
required

כתובת URL מלאה אליה הלקוח יופנה לאחר השלמת תהליך השינוי (הצלחה או ביטול). חייבת להיות URL תקינה.

Example:

"https://example.com/subscription-updated"

Response

בקשת השינוי נוצרה בהצלחה

​
success
boolean
required

מצב ההצלחה של הפעולה

Example:

true

​
data
object
required

פרטי בקשת השינוי שנוצרה