Kobaru
  1. Guides
Kobaru
  • Kobaru.io Gateway API
    • Introduction
      • What is Kobaru?
      • Quick start
      • How x402 works
    • Integration
      • Standard x402 SDK
      • Advanced SDK
      • Transparent proxy integration
      • Direct API integration
    • Core Concepts
      • Available Chains and Assets
      • Payment schemes
      • Security
      • Usage models
    • Guides
      • Pricing your API
      • Going to Production
      • Testing with devnet
      • Bazaar discovery
    • API Reference
      • Error Handling
      • Get Supported Payment Kinds
      • Verify Payment Authorization
      • Settle Payment
    • Discovery
      • List Discovery Resources
    • Schemas
      • SupportedResponse
      • ErrorResponse
      • UnauthorizedResponse
      • RateLimitResponse
      • VerifySuccessResponse
      • VerifyErrorResponse
      • SettleSuccessResponse
      • SettleErrorResponse
      • DiscoveryResourceItem
      • ListDiscoveryResourcesResponse
  1. Guides

Testing with devnet

Testing with devnet#

This guide walks you through testing your Kobaru integration using Solana Devnet. Devnet lets you verify your integration works correctly without spending real money.

What is devnet?#

Solana Devnet is a test network that mirrors mainnet behavior but uses valueless test tokens. Use it for:
Development and debugging
Integration testing
Demo environments
CI/CD pipelines

Step 1: Configure for devnet#

Update your integration to use the devnet network identifier:

SDK integration#

Transparent proxy#

In the Kobaru Console:
1.
Go to Services > [Your Service]
2.
Under Network, select Solana Devnet
3.
Save changes

Step 2: Get test USDC#

You need devnet USDC to make test payments. Here's how to get some:

Option 1: Circle USDC faucet#

1.
Visit the Circle USDC Faucet
2.
Select Solana Devnet
3.
Enter your wallet address
4.
Request test USDC

Option 2: Solana CLI#

Then use a faucet to get devnet USDC to your address.

Option 3: Use Kobaru test wallet#

Contact support@kobaru.io for access to a pre-funded test wallet.

Step 3: Test the payment flow#

Test 1: Verify 402 response#

Request your endpoint without payment:
Expected response:

Test 2: Verify payment acceptance#

Use an x402-compatible client to make a payment:

Test 3: Verify usage tracking#

For pay-per-request endpoints, verify the counter decrements:

Step 4: Test error scenarios#

Insufficient funds#

Use a wallet with no USDC:

Invalid transaction#

Construct a malformed transaction:

Expired usage#

For pay-per-request, exhaust the bundle:

Common testing issues#

"Network not supported"#

Cause: Your API key or capability isn't configured for devnet.
Solution: Enable the devnet capability in the Kobaru Console.

"Simulation failed"#

Cause: The test wallet doesn't have devnet USDC.
Solution: Get test tokens from a faucet.

"Invalid fee payer"#

Cause: Transaction not constructed correctly.
Solution: Ensure Kobaru's facilitator address is set as fee payer.

Token not found#

Cause: Using mainnet USDC address on devnet.
Solution: Use the devnet USDC address: 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU

Slow transaction confirmation#

Cause: Devnet can be slower or less reliable than mainnet.
Solution: Increase your timeout settings during testing. This is normal for devnet.

Environment variables#

Set up your development environment:

CI/CD integration#

Add automated testing to your pipeline:

Network comparison#

PropertyDevnetMainnet
Network IDsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
USDC address4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDUEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
Token valueNone (test tokens)Real USD value
Use caseDevelopment, testingProduction

Next steps#

Once your devnet tests pass:
1.
Production guide - Go-live checklist
2.
Pricing guide - Set your production prices
3.
Security - Review security best practices
Modified at 2026-01-04 13:57:30
Previous
Going to Production
Next
Bazaar discovery
Built with