Billing & Credits

InstaHuman uses a prepaid credit system. Credits are held in escrow when jobs are created and debited at settlement.

Pricing model:

You set the tester payout (e.g., $3.00/tester)
A 30% platform fee is added on top
Total escrow per tester = payout + fee (e.g., $3.90)
Unused escrow (unfilled slots) is released back to your balance

Get Billing Info

GET /owner/billing

Returns current credit balance, payment method status, and auto-reload settings.

Response

{
  "balanceCents": 50000,
  "hasPaymentMethod": true,
  "autoReload": {
    "enabled": true,
    "thresholdCents": 10000,
    "reloadAmountCents": 50000
  }
}

Add Credits

POST /owner/billing/add-credits

Charge your payment method and add credits to your account.

Request Body

{ "amountCents": 50000 }

Field	Type	Required	Description
`amountCents`	integer	Yes	Amount to add in cents (e.g., 50000 = $500)

Setup Payment Method

POST /owner/billing/setup

Creates a Stripe Setup Intent for adding a payment method. Returns a client secret for Stripe Elements or Checkout.

Response

{
  "clientSecret": "seti_..._secret_...",
  "publishableKey": "pk_..."
}

Configure Auto-Reload

POST /owner/billing/auto-reload

Automatically add credits when your balance drops below a threshold.

Request Body

{
  "enabled": true,
  "thresholdCents": 10000,
  "reloadAmountCents": 50000
}

Field	Type	Required	Description
`enabled`	boolean	Yes	Enable or disable
`thresholdCents`	integer	Yes	Trigger threshold
`reloadAmountCents`	integer	Yes	Amount to reload

Detach Payment Method

POST /owner/billing/detach-method

Remove the payment method on file. This also disables auto-reload.

Response

{ "ok": true }