Skip to main content
curl -X POST "https://api.chargefy.io/v1/subscription-schedules" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "phases": [
      {}
    ],
    "subscription": "sub_123"
  }'

{
  "id": "subsched_123",
  "object": "subscription_schedule",
  "canceled_at": null,
  "completed_at": null,
  "created_at": "2026-05-20T12:00:00Z",
  "current_phase": null,
  "current_phase_index": null,
  "customer": "cus_123",
  "end_behavior": "release",
  "livemode": true,
  "metadata": {},
  "phases": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-schedules/subsched_123/phases"
  },
  "released_at": null,
  "released_subscription": null,
  "start_date": "2026-05-20T12:00:00Z",
  "status": "not_started",
  "subscription": "sub_123",
  "updated_at": null
}
Cria uma schedule para uma subscription existente. Se a primeira fase começa agora, ela é aplicada imediatamente e a próxima fase é agendada.
​
subscription
string
required
Subscription que será controlada pela schedule. Também aceito como from_subscription.
​
start_date
string
Data de início da primeira fase. Aceita ISO 8601, Unix seconds ou now.
​
end_behavior
string
release ou cancel. Padrão: release.
​
phases
array
required
Fases sequenciais. Cada fase aceita items, start_date, end_date, collection_method, days_until_due, default_payment_method, discount, trial_end, trial_settings, proration_behavior e metadata.
curl -X POST "https://api.chargefy.io/v1/subscription-schedules" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "phases": [
      {}
    ],
    "subscription": "sub_123"
  }'

{
  "id": "subsched_123",
  "object": "subscription_schedule",
  "canceled_at": null,
  "completed_at": null,
  "created_at": "2026-05-20T12:00:00Z",
  "current_phase": null,
  "current_phase_index": null,
  "customer": "cus_123",
  "end_behavior": "release",
  "livemode": true,
  "metadata": {},
  "phases": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-schedules/subsched_123/phases"
  },
  "released_at": null,
  "released_subscription": null,
  "start_date": "2026-05-20T12:00:00Z",
  "status": "not_started",
  "subscription": "sub_123",
  "updated_at": null
}