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. Fintoc crea la Subscription cuando un SubscriptionIntent se completa correctamente. Para crear cobros a través de Fintoc, la Subscription debe tener status active.

Si tu integración existente solo inscribe cuentas bajo tu propio convenio bancario, el status no determina la vigencia del mandato en tu banco. Sigue Inscripción bajo tu propio convenio bancario en lugar de esperar la activación a través de Fintoc.

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` en Fintoc. Puede ser `pending`, `active`, `canceled` o `expired`. Solo puedes cobrar suscripciones con estado `active` a través de Fintoc. Para inscripciones bajo tu propio convenio bancario, confirma la vigencia del mandato con tu banco.

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.succeeded durante su creación.En cualquier otro momento, balance es null.

Inscripción bajo tu propio convenio bancario

Si usas el producto legacy Subscriptions de Fintoc solo para inscribir cuentas, tu banco gestiona los cobros posteriores bajo tu convenio. El flujo de inscripción de Fintoc termina cuando recibes subscription_intent.succeeded. Maneja los resultados de la inscripción en tu backend:

Escucha subscription_intent.succeeded para confirmar que tu cliente completó la inscripción. Guarda los campos subscription.id, subscription.account y subscription.reference_id que recibes.
Maneja subscription_intent.failed y subscription_intent.rejected para notificar a tu cliente que Fintoc no pudo confirmar una inscripción exitosa.

Después de una inscripción exitosa, confirma la activación del mandato y la disponibilidad para cobrar con tu banco antes de crear débitos bajo tu convenio. Un SubscriptionIntent exitoso no confirma la activación bancaria ni un débito exitoso. La Subscription que recibes puede permanecer en pending después de que tu banco active el mandato. No uses subscription.activated, subscription.canceled ni Subscription.status para activar o desactivar mandatos en tu integración con convenio propio. Un evento subscription.canceled con status expired informa la expiración de la Subscription en Fintoc, no confirma una cancelación bancaria. Confirma el estado actual del mandato con tu banco.

​El objeto Subscription

​Inscripción bajo tu propio convenio bancario

El objeto Subscription

Inscripción bajo tu propio convenio bancario