> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Subscription

```json theme={null}
{
    "id": "sub_m7N9rAWJS9dWDKEe",
    "object": "subscription",
    "account": {
        "id": "acc_nMNejK7BT8oGbvO4",
        "object": "account",
        "balance": {
            "available": 530000,
            "current": 530000,
            "limit": 1530000
        },
        "currency": "CLP",
        "holder_id": "134910798",
        "holder_name": "Jon Snow",
        "institution": {
            "id": "cl_banco_santander",
            "country": "cl",
            "name": "Banco Santander"
        },
        "name": "Cuenta Corriente",
        "number": "9530516286",
        "official_name": "Cuenta Corriente Moneda Local",
        "type": "checking_account"
    },
    "created_at": "2021-11-11T02:29:16Z",
    "mode": "live",
    "reference_id": null,
    "status": "active"
}
```

| Atributo       | Tipo     | Descripción                                                                                                                                                                                                                                                                         |
| -------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`           | `string` | Identificador único de la Subscription                                                                                                                                                                                                                                              |
| `object`       | `string` | Identificador del tipo de objeto. Su valor para las `Subscriptions` siempre corresponderá a `subscription`                                                                                                                                                                          |
| `account`      | `object` | Objeto que apunta a la cuenta bancaria que puede ser cobrada con esta suscripción.                                                                                                                                                                                                  |
| `created_at`   | `string` | Fecha de creación de la `Subscription`, usando ISO 8601                                                                                                                                                                                                                             |
| `mode`         | `string` | Indica si la `Subscription` está en modo `live` o en modo `test` (para el sandbox)                                                                                                                                                                                                  |
| `reference_id` | `string` | **ID opcional** provisto por el comercio que determinará cómo el banco identifica la suscripción en su portal. Si no se provee, se usará el `holder_id` del usuario. **La longitud debe estar entre 1 y 15 caracteres**, y solo está disponible para los clientes de Subscriptions. |
| `status`       | `string` | Estado de la Subscription. Puede ser `pending`, `active`, `canceled`.<br />Solo las suscripciones `active` pueden ser cobradas.                                                                                                                                                     |

<Warning>
  **Balance de la cuenta de la suscripción**

  Actualmente, el balance de la cuenta de las suscripciones solo está presente cuando se crean las suscripciones. Específicamente, cuando las suscripciones se reciben mediante eventos subscription\_intent.successful.

  En otros momentos el balance de la cuenta se mostrará como **null**.
</Warning>

Solo las **subscriptions** creadas por comercios de Direct Debit pueden ser cobradas y tener estado `active`.

Las **subscriptions** creadas por comercios de Subscriptions siempre tendrán estado `pending`.