Billing & credits

Pay-as-you-go credits via mobile money or card. No subscriptions.

Credit wallet

Every tenant has a single credit wallet. Each successful product call debits credits according to a flat per-op table (e.g. an email send costs 1 credit, an image generation costs 10). Failed calls are refunded automatically.

Top up credits

Buy a credit pack from /billing. Packs come in USD (Stripe Elements, card) and XAF (FreemoPay, mobile money). The dialog walks you through gateway selection and either embedded Stripe or a FreemoPay phone-confirmation wait.

What if my wallet goes empty?

Pre-debit guards short-circuit calls that would push the wallet negative — they return 402 E_INSUFFICIENT_CREDITS before contacting the provider. Top up to resume.

Errors

CodeHTTPDescriptionResolution
E_INSUFFICIENT_CREDITS402Wallet would go negative.Top up from /billing or via the dashboard API.
E_PAYMENT_GATEWAY_DECLINED402Stripe / FreemoPay declined the charge.Retry with another card or check your mobile-money balance.
E_PAYMENT_WEBHOOK_INVALID400Incoming gateway webhook failed signature verification.No action needed — Valienz drops invalid webhooks.