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.

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

Balance de la cuenta de la suscripciónEl 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.

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.

API de Fintoc

Recursos principales

API de Pagos

API de Transferencias

API de Movimientos

Direct Debit (Legacy)

API Fiscal

Objeto Subscription

El objeto Subscription

​El objeto Subscription

El objeto Subscription