FAQ

General Questions

What is Oura402?

Oura402 is the simplest way to accept x402 payments. We handle all blockchain complexity, allowing you to verify payments with a single API call.

How do I get started?

  1. Obtain your API key (requires approximately 30 seconds)

  2. Make an API call to verify payments

  3. This completes the setup process.

For detailed code examples, please refer to our Getting Started guide.

What is x402?

x402 is a payment standard that enables you to accept cryptocurrency payments over standard HTTP. This eliminates the need for wallet popups and blockchain complexity, providing a payment experience similar to standard API calls.

Learn more at x402.orgarrow-up-right

Do I need blockchain knowledge to use Oura402?

No, blockchain knowledge is not required. Oura402 handles all blockchain operations. If you can make an HTTP request, you can integrate Oura402.

Which blockchain does Oura402 support?

Oura402 currently supports Solana. We manage all blockchain interactions, so you never need to interact with the blockchain directly.

Getting Paid

How do I receive payments?

Simply provide your wallet address to Oura402. When a customer pays you through x402, we verify the payment and the funds are transferred to your wallet.

Do I need a special wallet?

Any Solana wallet is compatible with Oura402. If you do not have a wallet yet, we recommend Phantom or Solflare.

How long does it take to receive payments?

Payments are confirmed within 2-5 seconds on Solana, significantly faster than traditional payment processors which may take several days.

What are the fees?

Oura402 does not charge a percentage of your payments. You only pay for API usage. Please visit oura402.dev/pricingarrow-up-right for current plan details.

API & Integration

Is there an SDK available?

An SDK is not required. Oura402 uses standard HTTP endpoints, allowing you to use any HTTP client library you prefer.

Can I use this from my frontend application?

No, API keys should always be stored on the server side. Exposing your API key in frontend code creates a security risk.

What happens if the API experiences downtime?

Oura402 maintains 99.9% uptime. In the event of service disruption, please check oura402.dev/statusarrow-up-right for real-time updates.

What are the rate limits?

Rate limits depend on your subscription plan:

  • Free: 100 requests per minute

  • Paid: 1,000 requests per minute

  • Enterprise: Custom limits based on your requirements

See Rate Limits for complete details.

What happens if I exceed the rate limit?

You will receive a 429 Too Many Requests error response. You can either wait briefly before retrying or upgrade your plan to increase your rate limit.

Security

How should I protect my API key?

Follow these security best practices:

  • Store API keys in environment variables, not in source code

  • Never commit API keys to version control systems

  • Avoid exposing API keys in frontend code

  • Rotate keys regularly as part of your security policy

What should I do if my API key is compromised?

If you suspect your API key has been compromised:

  1. Navigate to your dashboard

  2. Delete the compromised key

  3. Generate a new API key

  4. Update your application with the new key

This process requires approximately 2 minutes to complete.

Is Oura402 secure?

Yes. Oura402 implements the same security standards as traditional payment processors. All API calls are encrypted, payments are verified on-chain, and we never hold custody of your funds.

Errors & Problems

I'm receiving errors. How do I troubleshoot?

Please consult our Error Handling guide. Common issues include:

  • Incorrect API key

  • Missing required fields in the request

  • Invalid wallet address format

Why is my payment verification failing?

Payment verification typically fails due to:

  • Incorrect payment proof

  • Payment amount does not match the expected value

  • Invalid or mismatched wallet address

Please verify that all parameters are correct.

Why is the API responding slowly?

Oura402 typically verifies payments within milliseconds. If you experience slow response times:

  1. Check oura402.dev/statusarrow-up-right for service status

  2. Verify you are not hitting rate limits

  3. Contact support if the issue persists

Support

How can I get help?

Support resources are available through multiple channels:

Is there a community for Oura402 users?

Follow us on Twitter @Oura402arrow-up-right for updates and to connect with other developers using Oura402.

How do I report a bug?

Please email [email protected] with the following information:

  • Description of what you were attempting to do

  • What occurred instead of the expected behavior

  • Any error messages received

  • Your API request (ensure you remove your API key before sending)

Best Practices

Should I implement retry logic for failed requests?

Yes, retry logic is recommended with the following considerations:

  • Retry recommended: Rate limit errors, network failures, timeouts

  • Do not retry: Invalid parameters, authentication errors, malformed wallet addresses

Implement exponential backoff to increase the delay between successive retry attempts.

How can I test my integration without using real funds?

Begin by testing with small payment amounts. Start with the minimum payment amount to verify your integration works correctly before deploying to production.

When should I use WebSockets instead of the REST API?

WebSockets are recommended for use cases requiring real-time updates:

  • Payment dashboards

  • Real-time payment notifications

  • Monitoring multiple concurrent payments

For standard verification workflows, the REST API is sufficient. See WebSocket API docs for implementation details.

  • Always validate that payment amounts match your expected values

  • Implement comprehensive logging for debugging purposes

  • Handle errors gracefully with appropriate user feedback

  • Start with a simple implementation and add complexity only when necessary

  • Review error messages carefully, as they typically indicate the specific issue

Last updated