Billing & credits

Credit packs through Stripe. Buy credits once, then spend them when paid delivery actions succeed.

How billing works

Credits live on the account, not on a single API token. Any active token can run paid actions against the same balance.

Certain operations are always free to encourage integration setup and testing:

Operation Cost Description
Login / credential validation Free Validating NDSP credentials costs nothing
Profile check Free Looking up a user's profile on Cortex Cloud
Preset listing Free Listing presets available in your account
Follow / unfollow 3 credits Sending or revoking a friend request
Preset share 10 credits Sharing a preset with another user
Capture share 10 credits Sharing a neural capture with another user

Credit packs

Cloud Bridge offers one-time credit packs. Bigger packs lower the unit cost without committing the account to a monthly plan.

View current packs: Check the Pricing page or call GET /api/account/credit-packs for pack details and pricing.

Every account includes:

  • Unlimited API key creation
  • Unlimited store integrations
  • Full usage analytics and delivery logs
  • Free operations (login, profile check, preset listing)

Buying credits

Checkout

From the Billing page in the dashboard, choose a credit pack and currency. Stripe Checkout collects payment, then the webhook credits the account.

Top-ups

Buy another pack whenever the balance runs low. Credits do not expire in the app.

Insufficient credits

Paid API calls return INSUFFICIENT_CREDITS when the account balance cannot cover the action. Free calls still work.

Stripe integration

All payment processing is handled by Stripe. Cloud Bridge never stores card details. Stripe webhooks reconcile credit purchases.

Supported currencies: USD, EUR, GBP, and other major currencies supported by Stripe. The currency is selected during checkout.

Credit balance API

You can check your current credit balance programmatically:

Check balance via API key
curl https://your-project.cloudfunctions.net/api/billing/balance \
  -H "x-api-key: ndsp_live_xxxxxxxxxxxxxxxx"
Response
{
  "success": true,
  "balance": {
    "credits": 187,
    "rateLimit": {
      "limit": 100,
      "remaining": 94,
      "resetsAt": "2026-03-14T13:00:00Z"
    }
  }
}

Or check via the dashboard using Firebase authentication:

Check balance via Firebase token
curl https://your-project.cloudfunctions.net/api/account/credits \
  -H "Authorization: Bearer <firebase-id-token>"

Pricing API

Retrieve the current credit pricing for all operations. These are public endpoints.

Get pricing
curl https://your-project.cloudfunctions.net/api/billing/pricing
Get credit packs
curl https://your-project.cloudfunctions.net/api/account/credit-packs
Response
{
  "success": true,
  "pricing": {
    "login": 0,
    "follow": 3,
    "unfollow": 3,
    "profileCheck": 0,
    "presetShare": 10,
    "presetList": 0,
    "captureShare": 10
  }
}