Credits

Buy credits (charges real money)

CHARGES REAL MONEY: this immediately charges the workspace's saved default payment method (the card behind the active subscription), off-session, with no confirmation step beyond this call. Buys between 1000 and 10000 prospect credits at the tiered list price ($33 per 1000 credits, $20 per 1000 from 5000 credits) and grants them to the wallet on success. Responds with the credits bought, the exact amount charged in USD and the new available balance. Errors carry a machine-readable code: billing_required (402, no active subscription or saved card - fix billing in the app first), payment_failed (402, the charge was refused - no money moved), credits_free (409, this workspace's credits are free, so nothing is charged and there is nothing to buy), invalid_request (400), temporarily_unavailable (503, the purchase stopped before any charge - safe to retry), purchase_incomplete (500, charged but not credited, support already notified - do NOT retry) and purchase_unconfirmed (500, check /credits/transactions before retrying). The grant is idempotent on the Stripe invoice, so one charge can never double-credit - but every successful call is a NEW charge.

post/credits/purchase

Request

  • Base URL: https://api.emailchaser.com/r
  • URL: https://api.emailchaser.com/r/credits/purchase
  • Auth: HTTP bearer

Request body

creditsinteger required

Credits is how many prospect credits to buy. Minimum 1000, maximum 10000 per call.

Example request

{
  "credits": 5000
}

Response

The completed purchase

amountUsdnumber

AmountUsd is what the saved default payment method was charged, in US dollars.

creditsPurchasedinteger

CreditsPurchased is how many credits were bought and granted.

newBalanceinteger

NewBalance is the available credit balance after the grant.

Example response

{
  "amountUsd": 100,
  "creditsPurchased": 5000,
  "newBalance": 5000
}

Changes

No recorded changes to this operation across all 1 revision of this API.