Customer Credits - Commet

Los customer credits son ajustes monetarios para un cliente y una moneda específica. Commet los aplica por orden de creación, antes de impuestos, sobre recibos recurrentes elegibles. Usalos para compensar una interrupción de servicio, aplicar un acuerdo comercial o corregir una cuenta. No son créditos del plan y los eventos de uso no los consumen.

Otorgá crédito

Abrí el customer en Customers para revisar su contexto de billing. Creá el crédito por API cuando el ajuste nazca en tu aplicación o en un workflow de soporte:

const credit = await commet.customers.createCredit(
  {
    id: 'cus_01J...',
    amount: 2500,
    currency: 'usd',
    reason: 'Crédito por interrupción del servicio',
  },
  { idempotencyKey: 'credit-acme-2026-08-16' },
)

amount usa la unidad mínima de la moneda. En USD, 2500 representa USD 25,00. Enviá siempre un motivo; forma parte del historial auditable del crédito.

Consultá el saldo restante

const credits = await commet.customers.listCredits({ id: 'cus_01J...' })

El crédito solo aplica a recibos de la misma moneda. Si un customer tuvo suscripciones en USD y BRL, cada moneda mantiene un saldo independiente.

Revocá crédito no utilizado

const revocation = await commet.customers.revokeCredit(
  { id: 'cus_01J...', creditId: 'crd_01J...' },
  { idempotencyKey: 'revoke-credit-acme-2026-08-16' },
)

La revocación elimina solo el remanente no asignado. No reescribe recibos que ya consumieron una parte del crédito. Para allowances del producto, usá Credits y Credit Packs. Para dar acceso sin billing, usá Plan Grants.