Add credit

POST/billing/deposit

Creates a Stripe Checkout session for a one-time credit deposit. Session token required. Redirect your user to the returned checkout_url. Balance is credited instantly on payment completion.

Request body

Parameter	Type	Required	Description
amount_usd	number	Yes	Amount to deposit in USD. Minimum $5, maximum $500.

Example

curl -X POST https://api.pinstripes.io/billing/deposit \
  -H "Authorization: Bearer <session-token>" \
  -H "Content-Type: application/json" \
  -d '{"amount_usd": 20}'

Response

{
  "checkout_url": "https://checkout.stripe.com/pay/cs_live_..."
}

Redirect the user to checkout_url. Stripe handles card collection and sends a webhook on success. The credit appears in the account balance within a few seconds of payment.