Credits

Account credits are monetary balances applied to your Nembl account that offset future billing charges. Credits reduce the amount charged to your payment method at the next billing cycle.

How Credits Work

Credits are applied automatically to invoices in the order they were issued. When an invoice is generated:

Nembl checks your credit balance.
If credits are available, they are applied to the invoice amount.
If credits cover the full invoice, no charge is made to your payment method.
If credits partially cover the invoice, the remaining balance is charged to your card.
Credits cannot result in a negative invoice (no payouts).

Credit Application Example

Event	Credit Balance	Invoice	Charged to Card
Credit issued: $100	$100	--	--
Monthly invoice: $149	$0	$149	$49
Credit issued: $50	$50	--	--
Monthly invoice: $49	$1	$49	$0

Viewing Your Credit Balance

Navigate to Settings > Billing > Credits to see:

Current balance -- the total credit amount available.
Credit history -- a log of all credits issued and applied, including dates, amounts, and descriptions.
Pending application -- credits that will be applied to the next invoice.

How Credits Are Issued

Credits are added to your account in the following situations:

Reason	Description
Plan downgrade proration	When downgrading, unused days on the higher plan are credited
Service disruption	If Nembl experiences downtime affecting your account, credits may be issued
Promotional offers	Trial extensions, referral bonuses, or marketing promotions
Billing adjustments	Corrections for incorrect charges
Enterprise agreements	Prepaid credits as part of an enterprise contract

Credits are not issued for regular plan cancellations. Cancellations stop future billing but do not refund the current period.

Credit Properties

Non-transferable -- credits belong to your company account and cannot be transferred to another account.
No expiration -- credits do not expire as long as your account is active.
No cash value -- credits cannot be converted to cash or refunded to your payment method.
Applied automatically -- you do not need to manually apply credits; they are used on the next invoice.
Single currency -- credits are denominated in USD.

Credit History

The credit history table shows every credit transaction:

Column	Description
Date	When the credit was issued or applied
Type	Issued (credit added) or Applied (credit used)
Amount	The credit amount
Description	Reason for the credit (e.g., "Downgrade proration", "Promotional credit")
Invoice	The invoice the credit was applied to (for Applied entries)
Balance	Running credit balance after this transaction

Multiple Credits

When multiple credits exist on your account, they are applied in FIFO order (first issued, first applied). Older credits are consumed before newer ones.

Credits and Plan Changes

Upgrading

When upgrading, you are charged the prorated difference for the current period. Credits are applied to this prorated charge if available.

Downgrading

When downgrading, the unused portion of the higher plan is issued as a credit. This credit is then applied to the next invoice under the new plan.

Cancelling

Outstanding credits remain on the account for 30 days after cancellation. If you resubscribe within that window, credits are available again. After 30 days, unclaimed credits are forfeited.

Checking Credits via API

Developers can query the credit balance programmatically:

curl -X GET https://api.nembl.com/v1/billing/credits \
  -H "x-api-key: your-api-key"

Response:

{
  "balance": 5000,
  "currency": "usd",
  "entries": [
    {
      "date": "2026-03-15T00:00:00Z",
      "type": "issued",
      "amount": 10000,
      "description": "Downgrade proration"
    },
    {
      "date": "2026-04-01T00:00:00Z",
      "type": "applied",
      "amount": -5000,
      "invoiceId": "inv_abc123",
      "description": "Applied to invoice"
    }
  ]
}

Amounts are in cents (5000 = $50.00).

Best Practices

Check credits before changing plans. View your credit balance before downgrading to understand how much will be credited back.
Monitor credit application. Review your billing history to confirm credits are being applied correctly.
Resubscribe within 30 days. If you cancel and have credits, resubscribe within 30 days to retain them.

Subscriptions Creating & Managing Secrets