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

# Subscription object

## The Subscription object

A `Subscription` represents an end user's enrolled bank account that authorizes direct debit collections, exposing the linked `account` and a `status`. It is created when a `SubscriptionIntent` succeeds. Only a `Subscription` with `status` `active` can be charged.

```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": "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"
}
```

| Attribute      | Type     | Description                                                                                                                                                                                                           |
| :------------- | :------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`           | `string` | Unique identifier for the Subscription                                                                                                                                                                                |
| `object`       | `string` | Identifier for the type of object. Its value for `Subscriptions` will always correspond to `subscription`                                                                                                             |
| `account`      | `object` | Object that points to the bank account that can be charged with this subscription.                                                                                                                                    |
| `created_at`   | `string` | `Subscription`'s creation date, using ISO 8601                                                                                                                                                                        |
| `mode`         | `string` | Indicates whether the `Subscription` is in `live` mode or in `test` mode (for the sandbox)                                                                                                                            |
| `reference_id` | `string` | Merchant-provided ID that determines how the bank identifies the subscription in its portal. If omitted, Fintoc uses the end user's `holder_id`. Must be 1 to 15 characters. Available only for subscription clients. |
| `status`       | `string` | Subscription status. Can be `pending`, `active`, `canceled`. Only `active` subscription can be charged.                                                                                                               |

<Warning>
  **Subscription account balance**

  Currently, subscriptions' account balance is only present when subscriptions are created. Specifically, when subscriptions are received via subscription\_intent.successful events.

  At other moments the account balance will be shown as `null`.
</Warning>

Only **subscriptions** created by Direct Debit merchants can be charged and have status `active`.

**Subscriptions** created by Subscriptions merchants will always have status `pending`.