{
  "type": "object",
  "properties": {
    "amount_bgn": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000000,
      "description": "Amount in BGN (decimals allowed), e.g. 10. Minimum 1."
    },
    "description": {
      "type": "string",
      "description": "What this payment is for (shown to the buyer, ≤200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after payment."
    },
    "issue_invoice": {
      "type": "boolean",
      "description": "true = Stripe automatically creates and emails a post-payment invoice (PDF + hosted invoice page). Ideal for B2B / VAT bookkeeping. Note: Stripe charges a small Invoicing fee per invoice issued."
    },
    "collect_tax_id": {
      "type": "boolean",
      "description": "true = ask the buyer for their business tax ID (e.g. EU VAT number) on the checkout page; it appears on the invoice. Combine with issue_invoice for a VAT-compliant receipt."
    }
  },
  "required": [
    "amount_bgn",
    "description"
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id returned by create_payment_link"
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "description": "The session_id of the paid payment (same id used by query_payment_status)"
    },
    "amount": {
      "type": "number",
      "description": "Optional partial-refund amount in the local currency major unit. Omit for a full refund."
    }
  },
  "required": [
    "session_id"
  ]
}

{
  "type": "object",
  "properties": {
    "amount_bgn": {
      "type": "number",
      "description": "Amount charged per billing period (local currency major unit)"
    },
    "interval": {
      "type": "string",
      "enum": [
        "month",
        "year",
        "week",
        "day"
      ],
      "description": "Billing period. Default \"month\"."
    },
    "description": {
      "type": "string",
      "description": "What the subscription is for (shown to the buyer, <=200 chars)"
    },
    "customer_email": {
      "type": "string",
      "description": "Optional buyer email (pre-filled at checkout; receipt goes there)."
    },
    "success_url": {
      "type": "string",
      "description": "Optional https URL to send the buyer to after subscribing."
    }
  },
  "required": [
    "amount_bgn",
    "description"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "session_id (cs_...) returned by create_subscription_link, or subscription_id (sub_...)"
    }
  },
  "required": [
    "id"
  ]
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "session_id (cs_...) or subscription_id (sub_...)"
    },
    "immediate": {
      "type": "boolean",
      "description": "true = cancel immediately. Default false = cancel at period end."
    }
  },
  "required": [
    "id"
  ]
}