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.

Subscription Object

{
  "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.

Subscription account balanceCurrently, 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.

Only subscriptions created by Direct Debit merchants can be charged and have status active. Subscriptions created by Subscriptions merchants will always have status pending.

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

Subscription object

The Subscription object

​The Subscription object

The Subscription object