---
updatedAt: 2026-03-12T01:23:59.000Z
agentTools:
  projectIndex: https://docs.ventipay.com/llms.txt
---

# Crear

Crea un nuevo objeto `Subscription`. Una vez creada la suscripción, el cliente debe autorizar su inicio.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.ventipay.com/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "BearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "security": [
    {
      "BearerAuth": []
    }
  ],
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "info": {
    "title": "Suscripciones",
    "description": "Endpoints para gestionar suscripciones, notas de venta, planes, productos, cupones e impuestos.",
    "version": "1"
  },
  "tags": [
    {
      "name": "Suscripciones",
      "description": "Una `Subscription` representa un cobro recurrente a un cliente según un intervalo definido."
    }
  ],
  "paths": {
    "/subscriptions": {
      "post": {
        "summary": "Crear",
        "description": "Crea un nuevo objeto `Subscription`. Una vez creada la suscripción, el cliente debe autorizar su inicio.",
        "operationId": "subscriptions-create",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "billing_cycle_anchor": {
                    "type": "string",
                    "enum": [
                      "now",
                      "1",
                      "2",
                      "3",
                      "4",
                      "5",
                      "6",
                      "7",
                      "8",
                      "9",
                      "10",
                      "11",
                      "12",
                      "13",
                      "14",
                      "15",
                      "16",
                      "17",
                      "18",
                      "19",
                      "20",
                      "21",
                      "22",
                      "23",
                      "24",
                      "25",
                      "26",
                      "27",
                      "28",
                      "29",
                      "30",
                      "31"
                    ]
                  },
                  "cancel_url": {
                    "type": "string"
                  },
                  "cancel_url_method": {
                    "type": "string",
                    "default": "post",
                    "enum": [
                      "get",
                      "post"
                    ]
                  },
                  "currency": {
                    "type": "string",
                    "enum": [
                      "clp",
                      "clf"
                    ]
                  },
                  "custom_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "default_products": {
                    "type": "array",
                    "description": "IDs de product",
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer",
                          "default": 0,
                          "format": "int32"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "default_tax_rates": {
                    "type": "array",
                    "description": "IDs de tax_rate",
                    "items": {
                      "properties": {
                        "id": {
                          "type": "string"
                        }
                      },
                      "type": "object"
                    }
                  },
                  "description": {
                    "type": "string"
                  },
                  "duration": {
                    "type": "integer",
                    "format": "int32"
                  },
                  "interval": {
                    "type": "string",
                    "enum": [
                      "1day",
                      "1week",
                      "2weeks",
                      "1month",
                      "3months",
                      "6months",
                      "1year"
                    ]
                  },
                  "metadata": {
                    "type": "string",
                    "format": "json"
                  },
                  "name": {
                    "type": "string"
                  },
                  "proration_behavior": {
                    "type": "string",
                    "enum": [
                      "create_prorations",
                      "full",
                      "none"
                    ]
                  },
                  "success_url": {
                    "type": "string"
                  },
                  "success_url_method": {
                    "type": "string",
                    "default": "post",
                    "enum": [
                      "get",
                      "post"
                    ]
                  },
                  "trial_days": {
                    "type": "integer",
                    "format": "int32"
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [
          {
            "BearerAuth": []
          }
        ],
        "tags": [
          "Suscripciones"
        ]
      }
    }
  }
}
```