Skip to main content
curl -X POST "https://api.chargefy.io/v1/subscriptions" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_123",
    "items": [
      {
        "price": "price_123"
      }
    ]
  }'

{
  "id": "sub_123",
  "object": "subscription",
  "billing_cycle_anchor": "2026-05-19T18:00:00Z",
  "billing_mode": {
    "type": "classic"
  },
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": null,
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": null
  },
  "collection_method": "charge_automatically",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "current_period_end": "2026-06-02T18:00:00Z",
  "current_period_start": "2026-05-19T18:00:00Z",
  "customer": "cus_123",
  "days_until_due": null,
  "default_payment_method": null,
  "ended_at": null,
  "items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-items?subscription=sub_123"
  },
  "latest_invoice": "in_123",
  "livemode": true,
  "metadata": {},
  "next_billing_at": "2026-06-02T18:00:00Z",
  "pause_collection": null,
  "payment_settings": {},
  "pending_setup_intent": "seti_123",
  "pending_update": null,
  "start_date": "2026-05-19T18:00:00Z",
  "status": "trialing",
  "trial_end": "2026-06-02T18:00:00Z",
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "pause"
    }
  },
  "trial_start": "2026-05-19T18:00:00Z",
  "updated_at": "2026-05-19T18:00:00Z"
}
Cria uma subscription para um customer. Sem trial, a subscription nasce incomplete e a primeira invoice fica aberta com um payment_intent. Quando a primeira cobrança é paga, a subscription vira active; se não for paga em até 23 horas, vira incomplete_expired.
​
customer
string
required
Customer da subscription (cus_*).
​
items
array
required
Itens recorrentes. Cada item usa price recorrente ou price_data.recurring.
​
default_payment_method
string
Payment method salvo (pm_*). Quando enviado, a primeira cobrança é enfileirada automaticamente.
​
collection_method
string
charge_automatically ou send_invoice. Padrão: charge_automatically.
​
days_until_due
integer
Dias até vencimento quando collection_method é send_invoice.
​
discount
string
Desconto aplicado às invoices da subscription.
Em uma subscription com trial, se default_payment_method não for enviado, a resposta inclui pending_setup_intent. Busque esse setup intent para obter o client_secret e confirmar um cartão antes do fim do trial.
​
trial_period_days
integer
Dias de trial. Durante o trial a subscription fica trialing. Use apenas um entre trial_period_days e trial_end.
​
trial_end
string
Timestamp ISO 8601 exato para o fim do trial. Use apenas um entre trial_end e trial_period_days.
​
trial_settings
object
Política de fim de trial.
​
metadata
object
Metadata livre.
curl -X POST "https://api.chargefy.io/v1/subscriptions" \
  -H "Authorization: Bearer {{API_KEY}}" \
  -H "Content-Type: application/json" \
  -d '{
    "customer": "cus_123",
    "items": [
      {
        "price": "price_123"
      }
    ]
  }'

{
  "id": "sub_123",
  "object": "subscription",
  "billing_cycle_anchor": "2026-05-19T18:00:00Z",
  "billing_mode": {
    "type": "classic"
  },
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": null,
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": null
  },
  "collection_method": "charge_automatically",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "current_period_end": "2026-06-02T18:00:00Z",
  "current_period_start": "2026-05-19T18:00:00Z",
  "customer": "cus_123",
  "days_until_due": null,
  "default_payment_method": null,
  "ended_at": null,
  "items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-items?subscription=sub_123"
  },
  "latest_invoice": "in_123",
  "livemode": true,
  "metadata": {},
  "next_billing_at": "2026-06-02T18:00:00Z",
  "pause_collection": null,
  "payment_settings": {},
  "pending_setup_intent": "seti_123",
  "pending_update": null,
  "start_date": "2026-05-19T18:00:00Z",
  "status": "trialing",
  "trial_end": "2026-06-02T18:00:00Z",
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "pause"
    }
  },
  "trial_start": "2026-05-19T18:00:00Z",
  "updated_at": "2026-05-19T18:00:00Z"
}

{
  "id": "sub_123",
  "object": "subscription",
  "billing_cycle_anchor": "2026-05-19T18:00:00Z",
  "billing_mode": {
    "type": "classic"
  },
  "cancel_at": null,
  "cancel_at_period_end": false,
  "canceled_at": null,
  "cancellation_details": {
    "comment": null,
    "feedback": null,
    "reason": null
  },
  "collection_method": "charge_automatically",
  "created_at": "2026-05-19T18:00:00Z",
  "currency": "brl",
  "current_period_end": "2026-06-19T18:00:00Z",
  "current_period_start": "2026-05-19T18:00:00Z",
  "customer": "cus_123",
  "days_until_due": null,
  "default_payment_method": "pm_123",
  "ended_at": null,
  "items": {
    "object": "list",
    "data": [],
    "has_more": false,
    "url": "/v1/subscription-items?subscription=sub_123"
  },
  "latest_invoice": "in_123",
  "livemode": true,
  "metadata": {},
  "next_billing_at": "2026-06-19T18:00:00Z",
  "pause_collection": null,
  "payment_settings": {},
  "pending_setup_intent": null,
  "pending_update": null,
  "start_date": "2026-05-19T18:00:00Z",
  "status": "incomplete",
  "trial_end": null,
  "trial_settings": {
    "end_behavior": {
      "missing_payment_method": "create_invoice"
    }
  },
  "trial_start": null,
  "updated_at": null
}