Add Credits to Wallet

Add credits to the authenticated team's wallet balance.

Choose one of three modes:

Omit guest_mode and direct_charge → hosted Stripe Checkout link is returned.

Set guest_mode: true → shareable white-label Checkout link. Requires success_url.

Set direct_charge: true → the team's default payment method is charged immediately and credits are added synchronously. Requires a saved default payment method on file.

direct_charge and guest_mode are mutually exclusive.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200Success - Hosted Checkout

application/json

Returned for hosted-checkout mode (default) and guest_mode. Open the payment_link in a browser (or share it with the end user in guest mode) to complete payment. Track the outcome with GET /v1/api/billing/wallet/status?session_id=....

Bodyapplication/json

🟢200Success - Direct Charge

🟠400Bad Request

🟠401Unauthorized

🟠402Payment Declined (Direct Charge)

🔴500Internal Server Error

curl --location 'https://api.inboxkit.com/v1/api/billing/wallet' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "credits": 50, "direct_charge": false, "guest_mode": false, "success_url": "https://your-app.com/payment/success", "cancel_url": "https://your-app.com/payment/cancel", "redirect_url": "/dashboard/billing" }'

{ "error": false, "message": "Payment link generated successfully", "payment_link": "https://checkout.stripe.com/c/pay/cs_test_a1b2c3...", "session_id": "cs_test_a1b2c3d4e5f6g7h8..." }