> ## 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

## El objeto Subscription

Una `Subscription` representa la cuenta bancaria inscrita de un usuario final que autoriza cobros por débito directo. Expone la `account` vinculada y un `status`. Se crea cuando un `SubscriptionIntent` se completa correctamente. Solo puedes cobrar una `Subscription` cuyo `status` sea `active`.

```json Subscription Object theme={null}
{
  "id": "sub_m7N9rAWJS9dWDKEe",
  "object": "subscription",
  "account": {
    "id": "acc_nMNejK7BT8oGbvO4",
    "object": "account",
    "balance": {
      "available": 530000,
      "current": 530000,
      "limit": 1530000
    },
    "currency": "CLP",
    "holder_id": "111111111",
    "holder_name": "Test Customer 1",
    "institution": {
      "id": "cl_banco_santander",
      "country": "cl",
      "name": "Banco Santander"
    },
    "name": "Cuenta Corriente",
    "number": "0000000000",
    "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. Para los objetos `Subscription`, su valor siempre es `subscription`.                                                                                                                                                               |
| `account`      | `object` | Cuenta bancaria vinculada que puedes cobrar con esta suscripción.                                                                                                                                                                                                    |
| `created_at`   | `string` | Fecha y hora de creación de la `Subscription`, en formato ISO 8601.                                                                                                                                                                                                  |
| `mode`         | `string` | Modo de la `Subscription`. Puede ser `live` o `test`; usa `test` para el sandbox.                                                                                                                                                                                    |
| `reference_id` | `string` | Identificador proporcionado por el comercio que determina cómo el banco identifica la suscripción en su portal. Si lo omites, Fintoc usa el `holder_id` del usuario final. Debe tener entre 1 y 15 caracteres y solo está disponible para clientes de Subscriptions. |
| `status`       | `string` | Estado de la `Subscription`. Puede ser `pending`, `active` o `canceled`. Solo puedes cobrar una suscripción con estado `active`.                                                                                                                                     |

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

  El `balance` de la cuenta solo está disponible cuando recibes la suscripción mediante un evento `subscription_intent.successful` durante su creación.

  En cualquier otro momento, `balance` es `null`.
</Warning>

Solo puedes cobrar las **subscriptions** creadas por comercios de Direct Debit que tengan estado `active`.

Las **subscriptions** creadas por comercios de Subscriptions siempre tienen estado `pending`.