Documentation

Purchasing API Credits

Last Updated: October 15, 2025 Category: Billing

Overview

When your free credits run low or you need more capacity for production use, you can purchase additional credits instantly through the WaymakerOne dashboard. Credits are charged to your saved payment method via Stripe and added to your balance immediately.

Prerequisites

Active Waymaker organization
API key created (triggers free 100 credit grant)
Payment method added to your Stripe account

💡 Tip: You'll be prompted to add a payment method on your first credit purchase if you haven't already.

Step-by-Step: Purchase Credits

Step 1: Navigate to API Billing

From the WaymakerOne dashboard:

Click "API Keys" in the left navigation
Select the "Billing & Credits" tab
Your current credit balance displays at the top

Current Balance Example:

Credits Remaining: 47 credits ($0.47)
⚠️ Low balance - Consider purchasing more credits

Step 2: Click "Purchase Credits"

Click the "Purchase Credits" button to open the purchase modal.

First time purchasing? You'll be prompted to add a payment method before selecting an amount.

Step 3: Add Payment Method (First Time Only)

If you haven't saved a payment method yet:

Click "Add Payment Method" in the purchase modal
You'll be redirected to Stripe Customer Portal (secure payment page)
Click "Add payment method"
Enter your credit card details:
- Card number
- Expiration date
- CVC code
- Billing address
Click "Save"
You'll be redirected back to WaymakerOne

Security Note: Payment details are stored securely by Stripe. Waymaker never sees or stores your full card number.

Step 4: Select Purchase Amount

Choose from the available credit packages:

Amount	Credits Received	Bonus	Total Cost
Starter	500 credits	—	$5.00
Popular	1,000 credits	+100	$10.00
Value	2,500 credits	+250	$25.00
Pro	5,000 credits	+500	$50.00
Business	10,000 credits	+1,500	$100.00

💡 Tip: The $10, $25, $50, and $100 options include bonus credits (10-15% extra), making them more cost-effective.

What can you do with each tier?

500 credits ($5):

~35 framework requests
~20 research requests
Perfect for testing and light use

1,100 credits ($10):

~75 framework requests
~40 research requests
Recommended starting point

5,500 credits ($50):

~375 framework requests
~200 research requests
Good for moderate production use

11,500 credits ($100):

~780 framework requests
~420 research requests
Best for high-volume applications

Step 5: Review and Confirm

Before finalizing:

Review the purchase details:
- Credits to be added
- Total charge amount
- Payment method (last 4 digits)
- New balance after purchase
Click "Purchase"

Example confirmation:

Purchase Summary:
├── Credits to Add: 1,100 credits (1,000 + 100 bonus)
├── Charge Amount: $10.00
├── Payment Method: •••• 4242
└── New Balance: 1,147 credits

Step 6: Purchase Complete

On successful purchase:

✅ Credits added to your balance immediately
✅ Purchase confirmation displayed
✅ Email receipt sent (from Stripe)
✅ Transaction logged in purchase history

You can start using credits immediately - no waiting period.

Payment Methods

Supported Cards

Accepted via Stripe:

Visa
Mastercard
American Express
Discover
Diners Club
JCB

International cards: Supported worldwide (charges in USD)

Prepaid cards: Most prepaid cards accepted

Managing Payment Methods

Update Your Card

Navigate to API Keys → Billing & Credits
Click "Manage Payment Methods"
You'll be redirected to Stripe Customer Portal
Click "Update" next to your current card
Enter new card details
Click "Save"

💡 Tip: Updated payment methods take effect immediately for future purchases and auto top-ups.

Add Additional Cards

You can save multiple payment methods:

In Stripe Customer Portal, click "Add payment method"
Enter card details
Set as default if you want it used for future purchases
Click "Save"

Note: Only the default payment method is used for credit purchases and auto top-ups.

Remove a Card

In Stripe Customer Portal, find the card to remove
Click "Remove"
Confirm removal

⚠️ Warning: You must have at least one payment method on file to purchase credits or use auto top-up.

Purchase History

View Past Purchases

Access your complete purchase history:

Navigate to API Keys → Billing & Credits
Scroll to "Purchase History" section
View table with:
- Purchase date and time
- Credits purchased (base + bonus)
- Amount charged
- Payment method used
- Purchase type (Manual or Auto Top-Up)
- Status (Completed, Failed, Refunded)

Filter Options:

Date range
Purchase type (Manual vs Auto)
Amount range

Download Receipts

For each purchase:

Click the receipt icon next to the transaction
Opens PDF invoice from Stripe
Save or print for your records

Receipt includes:

Invoice number
Purchase date
Itemized charges (credits + bonus)
Payment method
Billing address
Tax ID (if applicable)

💡 Tip: All receipts are also sent to your email address on file.

Troubleshooting

Payment Declined

Error Message:

Payment failed: Your card was declined.

Common Causes:

Insufficient funds
Card expired
Incorrect billing address
Card issuer blocking the charge
Daily spending limit exceeded

Solutions:

Try a different card - Add another payment method
Contact your bank - Verify the charge wasn't flagged as suspicious
Check billing address - Must match card on file
Update expired card - Add new expiration date

Payment Succeeded But Credits Not Added

Rare issue: Payment processed but credits didn't appear in your balance.

Steps to resolve:

Wait 2-3 minutes - Processing delay is normal
Refresh the page - Hard refresh (⌘⇧R or Ctrl+Shift+R)
Check purchase history - Verify transaction status
Contact support - If still missing after 10 minutes

Include in support request:

Transaction timestamp
Amount charged
Last 4 digits of card used
Expected credit amount

Duplicate Charges

If you see multiple charges for the same purchase:

Causes:

Clicking "Purchase" multiple times (don't do this!)
Browser refresh during payment
Network timeout causing retry

Solution:

Check your purchase history in WaymakerOne
Check your Stripe receipt emails
If truly duplicate, contact support@waymakerone.com with:
- Both transaction IDs
- Charge amounts and timestamps
- Request refund for duplicate

Prevention: Click "Purchase" once and wait for confirmation. Don't refresh during payment.

Can't Add Payment Method

Error when trying to add a card:

Possible causes:

Browser blocking Stripe popup
Ad blocker interfering
Cookies disabled
Unsupported card type

Solutions:

Disable ad blockers temporarily
Enable popups for waymakerone.com
Try a different browser (Chrome, Firefox, Safari)
Use incognito/private mode to rule out extensions
Clear browser cache and try again

Best Practices

1. Start Small

For new developers:

Purchase $10 (1,100 credits) to start
Monitor usage for 1-2 weeks
Understand consumption patterns
Scale up based on actual needs

Avoid: Purchasing $100 immediately without understanding usage.

2. Purchase Based on Usage

Review your usage analytics before purchasing:

Check API Usage dashboard
Note average credits per day/week
Calculate 2-4 week supply
Add 20% buffer for spikes

Example calculation:

Average usage: 50 credits/day
30-day supply: 50 × 30 = 1,500 credits
With 20% buffer: 1,500 × 1.2 = 1,800 credits
Recommended purchase: $25 (2,750 credits)

3. Consider Auto Top-Up

For production applications:

Enable Auto Top-Up instead of manual purchases
Set threshold to trigger before running out
Set monthly spending limit for budget control
Prevents service interruptions

Manual purchasing works best for:

Development and testing
Unpredictable usage patterns
Tight budget control

4. Keep Payment Method Current

Maintain valid payment information:

Check expiration dates quarterly
Update before cards expire
Have a backup payment method
Monitor failed payment notifications

Refund Policy

Standard Policy

Credit purchases are non-refundable except in these cases:

✅ Eligible for refund:

Billing errors (double charges, wrong amounts)
Service outages preventing API use
Unauthorized or fraudulent charges
Credits purchased but never used (within 7 days)

❌ Not eligible for refund:

Credits already consumed via API calls
Change of mind after using credits
Dissatisfaction with API responses
Switching to a different service

Request a Refund

To request a refund:

Email support@waymakerone.com
Include:
- Purchase date and amount
- Transaction ID (from receipt)
- Reason for refund request
- Current credit balance
Response within 2 business days

Processing time: 5-10 business days after approval

Security & Privacy

Payment Security

Your payment information is secure:

✅ PCI DSS Level 1 compliant (via Stripe)
✅ Encrypted transmission (TLS 1.3)
✅ Tokenized storage (Waymaker never sees full card numbers)
✅ 3D Secure support for fraud prevention
✅ No stored CVV codes (required fresh each time)

What Waymaker stores:

Last 4 digits of card
Card brand (Visa, Mastercard, etc.)
Expiration month/year
Billing ZIP code

What only Stripe stores:

Full card number
CVV code
Complete billing address

Privacy

Purchase information collected:

Transaction amounts and dates
Credits purchased
Payment methods used (tokenized)
IP address (fraud prevention)

Not collected or stored:

Full credit card numbers
CVV/CVC codes
Card PINs

See our Privacy Policy for complete details.

Next Steps

Now that you know how to purchase credits, learn about:

Auto Top-Up Configuration - Automate credit purchases
Credit System Overview - Understanding credit consumption
Usage Tracking - Monitor your API usage
Spending Limits - Control monthly costs

Questions about purchasing? → Contact support@waymakerone.com