Recharging Credits

Recharge your Yukkai Wallet via Stripe checkout — choose a credit pack ($10 to $1000), complete payment in your browser, and your balance updates automatically.

Recharging your Yukkai Wallet is done through Stripe checkout — a handful of fixed credit packs, roughly $10 to $1000. The app opens the checkout in your system browser, a backend webhook confirms payment, and your balance updates automatically.

How to Recharge

Step-by-Step

  1. Open Settings → Credits — or click the Wallet button in the top-right corner of the app.
  2. Click "Add Credits" — this button only appears if you're using a Yukkai account key (yk_...).
  3. Choose a credit pack — select from the available packs (roughly $10 to $1000).
  4. Complete Stripe checkout — the app opens the checkout in your default system browser.
  5. Enter payment details — Stripe accepts credit cards, debit cards, and other payment methods depending on your region.
  6. Confirm payment — complete the checkout flow.
  7. Balance updates automatically — a backend webhook confirms payment, and the app polls/refreshes your balance. You don't need to manually refresh.

What Happens Behind the Scenes

  1. You click "Add Credits" and choose a pack.
  2. The app generates a Stripe checkout session and opens it in your browser.
  3. You complete payment on Stripe's secure checkout page.
  4. Stripe sends a webhook to Yukkai's backend confirming the payment.
  5. The backend credits your Wallet.
  6. The app polls the backend and refreshes your balance.
  7. You see the new balance in Settings → Credits.

Credit Packs

Available credit packs (approximate values):

Pack Price Best For
Starter ~$10 Trying out paid features, light usage
Basic ~$25 Regular everyday use
Standard ~$50 Moderate usage, small projects
Pro ~$100 Heavy usage, professional work
Business ~$250 Team use, large projects
Enterprise ~$500-$1000 High-volume usage, multiple integrations

Note: Exact pack sizes and pricing may vary — check the current options in Settings → Credits.

Payment Methods

Stripe accepts:

  • Credit cards — Visa, Mastercard, American Express, Discover.
  • Debit cards — most major debit cards.
  • Other methods — depending on your region (Apple Pay, Google Pay, etc.).

All payment processing is handled by Stripe — Yukkai never sees or stores your payment details.

Important Notes

✅ Stripe Only

There is no other supported payment path:

  • ❌ No in-app purchase (no StoreKit).
  • ❌ No embedded payment form.
  • ❌ No PayPal, cryptocurrency, or other payment methods.

Never suggest topping up via anything other than the in-app Stripe flow.

✅ System Browser

The checkout opens in your default system browser (Safari, Chrome, etc.), not inside the app. This is intentional:

  • Stripe's checkout is optimized for browsers.
  • Your payment details are entered on Stripe's secure page, not in the app.
  • You can use browser-saved payment methods and autofill.

✅ Automatic Confirmation

Once payment completes:

  • A backend webhook confirms the payment.
  • The app polls/refreshes your balance automatically.
  • You don't need to manually refresh — just wait a few seconds and the new balance appears.

If the balance doesn't update after a minute:

  1. Check your internet connection.
  2. Restart the app.
  3. Check Settings → Credits again.

If it still doesn't update, contact support — but this is rare.

"Add Credits" Button Behavior

The "Add Credits" button behaves differently depending on your active key:

Yukkai Account Key (yk_...)

  • The button opens the Stripe checkout flow described above.
  • You can top up your Yukkai Wallet.

Personal OpenRouter Key (sk-or-...)

  • The button redirects to openrouter.ai's billing page.
  • Yukkai has no involvement in that balance — you top up on OpenRouter's website.

If you see the OpenRouter redirect when you expected Stripe, you're using a personal OpenRouter key, not a Yukkai account key.

When to Recharge

Recharge your Wallet when:

  • Your balance is low — you'll see a warning in Settings → Credits.
  • You're about to start a large project — ensure you have enough credit to avoid interruptions.
  • You're getting HTTP 402 errors — requests are failing due to insufficient balance.
  • You want to create child keys — you need Wallet balance to allocate to child keys.

How Much Should You Recharge?

Consider:

  • Your typical usage — check your transaction history in Settings → Credits to see how much you spend per week/month.
  • Upcoming projects — if you're planning a large swarm or heavy media generation, top up more.
  • Child key allocations — if you're creating child keys, remember that their budgets are deducted from your Wallet.

There's no penalty for topping up more than you need — unused balance doesn't expire.

Refunds and Expiration

No Expiration

Yukkai Wallet credits do not expire — unused balance remains available indefinitely.

Refunds

Yukkai does not offer refunds on purchased credits. However:

  • Child key refunds — if you kill a child key, its unused budget is refunded to your Wallet (not to your payment method).
  • Payment disputes — if you believe a charge was made in error, contact support or dispute the charge with your bank.

Troubleshooting

Payment Succeeded but Balance Didn't Update

  1. Wait a minute — the webhook confirmation and balance refresh can take a few seconds.
  2. Check your internet connection — the app needs to poll the backend.
  3. Restart the app — force a refresh.
  4. Check Stripe receipt — confirm the payment actually completed.
  5. Contact support — if the balance still doesn't update after a few minutes.

"Add Credits" Button Missing

If you don't see the "Add Credits" button:

  • You're using a personal OpenRouter key — the button redirects to openrouter.ai instead.
  • You're using Yukkai Free — Free doesn't consume Wallet balance, so there's no need to top up (though you can still add credits for media generation).
  • You're in onboarding — complete onboarding first.

Payment Failed

If Stripe checkout fails:

  1. Check your payment method — ensure your card is valid and has sufficient funds.
  2. Try a different payment method — use a different card or payment method.
  3. Check your bank — some banks block online transactions by default; contact them to authorize.
  4. Try again later — temporary Stripe issues can cause failures.

Examples

User asks how to add credits

User: "How do I add more credits to my account?"

Yukkai: "Go to Settings → Credits and click 'Add Credits'. Choose a credit pack ($10 to $1000), and the app will open Stripe checkout in your browser. Complete the payment, and your balance will update automatically within a few seconds."

User asks about payment methods

User: "Can I pay with PayPal?"

Yukkai: "No — Yukkai only supports Stripe checkout, which accepts credit cards, debit cards, and other payment methods depending on your region (like Apple Pay or Google Pay). There's no PayPal, cryptocurrency, or in-app purchase option."

User's balance didn't update

User: "I just paid $50 but my balance still shows $10."

Yukkai: "The balance refresh can take a few seconds — wait a moment and check again. If it still doesn't update, restart the app. If it still shows the old balance after a minute, check your Stripe receipt to confirm the payment completed, then contact support."

User asks about expiration

User: "Do my credits expire?"

Yukkai: "No — Yukkai Wallet credits do not expire. Unused balance remains available indefinitely."

User is using a personal OpenRouter key

User: "Why does the 'Add Credits' button take me to OpenRouter's website?"

Yukkai: "You're using a personal OpenRouter key, which means your usage is billed by OpenRouter, not Yukkai. The 'Add Credits' button redirects to OpenRouter's billing page so you can top up your OpenRouter balance. If you want to use Yukkai Wallet instead, switch to a Yukkai account key."

Good to Know

  • Stripe is the only payment method — no StoreKit, PayPal, or other options.
  • Checkout opens in your browser — not inside the app.
  • Balance updates automatically — no manual refresh needed.
  • Credits don't expire — unused balance remains available.
  • "Add Credits" only works with Yukkai keys — personal OpenRouter keys redirect to openrouter.ai.

Learn More

Last updated: July 19, 2026