Skip to main content
POST
/
subscriptions
/
events
建立訂閱事件
curl --request POST \
  --url https://api.zangsho.com/v1/subscriptions/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customer_email": "customer@example.com",
  "event_type": "upgrade",
  "old_amount": "500.00",
  "new_amount": "990.00",
  "amount_change": "490.00",
  "old_plan": "Basic",
  "new_plan": "Pro",
  "occurred_at": "2026-01-09T00:00:00Z"
}
'
{
  "data": {
    "id": 123,
    "customer_id": 123,
    "event_type": "created",
    "source": "api",
    "old_amount": "<string>",
    "new_amount": "<string>",
    "amount_change": "<string>",
    "old_plan": "<string>",
    "new_plan": "<string>",
    "occurred_at": "2023-11-07T05:31:56Z",
    "created_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

Authorization
string
header
required

使用 Laravel Sanctum Token 進行認證。

Token 可在商家後台的「API 設定」頁面取得。

Body

application/json
customer_email
string<email>
required

客戶 Email

event_type
enum<string>
required

事件類型

Available options:
created,
upgrade,
downgrade,
cancel,
reactivated
amount_change
string
required

MRR 變化金額

Example:

"490.00"

occurred_at
string<date-time>
required

事件發生時間

old_amount
string

變更前金額

new_amount
string

變更後金額

old_plan
string

變更前方案

new_plan
string

變更後方案

metadata
object

Response

事件建立成功

data
object