Plăți Recurente

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules?page=1&limit=20` +
    // status: pending | active | payment_method_required | paused | cancelling | completed | cancelled
    `&status=active&direction=outbound` +
    `&include=receiver_user,phases,payments` +
    `&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const scheduleId = "your_schedule_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}` +
    // includes: sender_user, receiver_user, contract, billing_package,
    // subscription_term, phases, payments, deleted_by_user
    `?include=phases,payments,receiver_user,billing_package`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    management_type: "app_managed",   // this reference only covers app_managed
    direction: "outbound",            // outbound = you bill a customer; inbound = you are billed
    status: "active",                 // start billing right away

    organization_sender_user_id: "org_user_sender_id",     // the biller (you)
    organization_receiver_user_id: "org_user_receiver_id", // the customer (required for outbound)

    currency: "EUR",
    payment_method: "stripe_card_payment", // bank_transfer | card_payment | stripe_card_payment | paypal | cash | paid_by_personal_funds
    organization_user_payment_method_id: "payment_method_id", // saved card to auto-charge (must belong to the receiver)

    name_lang_map: { en: "Monthly Retainer" },   // per-locale maps, not plain strings
    note_lang_map: { en: "Includes support and hosting." },

    is_email_notifications_active: true,
    email_notifications_to: "billing@acme.example",

    // customer self-service toggles (what the recipient may do from the portal)
    customer_can_reconfigure: false,
    customer_can_cancel: true,
    customer_can_pause: false,

    // totals + dates (total, paid_total, starts_at, ends_at, next_payment_create_at)
    // are computed by the engine, do NOT send them.

    // phases are valid ONLY for app_managed (stripe_hosted rejects them). Max 20.
    phases: [
      {
        frequency: "monthly",           // weekly | biweekly | monthly | yearly
        execute_after: "2026-08-01",    // first run date for this phase
        max_occurrences: 12,            // stop after N invoices (omit for open-ended)
        due_date_type: "custom_days",   // immediate | end_of_month | custom_days
        due_date_days: 14,              // required only when due_date_type = custom_days
        order: 0,
        line_items: [
          {
            name_lang_map: { en: "Retainer" }, // required unless organization_product_id is set
            quantity: 1,
            price: 500.00,                     // money: signed decimal in MAJOR units (not cents)
            organization_tax_class_id: "tax_class_id"
          },
          {
            organization_product_id: "product_id", // pulls name / tax defaults from the product
            quantity: 2,
            price: 49.90
          }
        ]
      }
    ]
  })
});

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    management_type: "app_managed",   // package-managed requires app_managed
    direction: "outbound",            // package-managed requires outbound
    status: "active",
    organization_sender_user_id: "org_user_sender_id",
    organization_receiver_user_id: "org_user_receiver_id",
    organization_user_payment_method_id: "payment_method_id",

    // attach a SUBSCRIPTION package, it defines the phases & line items
    organization_billing_package_id: "billing_package_id",

    // optional: pick the cadence variant; omit to use the package default
    organization_billing_package_subscription_term_id: "subscription_term_id",

    // optional: choose which package group items (and quantities) to include
    selected_group_items: [
      { id: "group_item_id_1", quantity: 1 },
      { id: "group_item_id_2", quantity: 3 }
    ]

    // NOTE: mutually exclusive with `phases`, the package supplies them.
  })
});

const organizationId = "your_org_id";
const scheduleId = "your_schedule_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // lifecycle: active <-> paused; set "cancelling" to stop at the end of the cycle
    status: "paused",
    note_lang_map: { en: "Paused at customer request." },
    is_email_notifications_active: false,
    customer_can_cancel: true

    // to change WHAT gets billed on a package-managed schedule,
    // use /reconfigure below rather than editing here.
  })
});

const organizationId = "your_org_id";
const scheduleId = "your_schedule_id";
const token = "YOUR_TOKEN_HERE";

const headers = {
  Authorization: `Bearer ${token}`,
  "Content-Type": "application/json"
};

const changes = {
  organization_billing_package_id: "billing_package_id",
  organization_billing_package_subscription_term_id: "subscription_term_id",
  selected_group_items: [
    // price_override + pricing_currency let you deviate from the package price
    { id: "group_item_id", quantity: 2, price_override: 39.00, pricing_currency: "EUR" }
  ],
  custom_line_items: [
    { name_lang_map: { en: "One-off setup" }, quantity: 1, price: 150.00 }
  ],
  // how the switch is billed: none | prorate_immediately | prorate_next_invoice
  // (prorate_immediately requires an active schedule)
  proration_mode: "prorate_next_invoice"
};

// 1. Preview, no changes are applied; returns the new composition + proration
await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}/preview-reconfigure`,
  { method: "POST", headers, body: JSON.stringify(changes) }
);

// 2. Apply
await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}/reconfigure`,
  { method: "PUT", headers, body: JSON.stringify(changes) }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/billing-schedules/analytics/summary` +
    // analyticsType: summary | history_monthly
    `?direction=outbound&convert_to_currency=EUR`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const scheduleId = "your_schedule_id";
const token = "YOUR_TOKEN_HERE";

// soft delete, restore via POST /billing-schedules/restore/{scheduleId}
fetch(`https://api.enlivy.com/organizations/${organizationId}/billing-schedules/${scheduleId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  }
});