NO FRICTION,
ONLY FAST PAYMENTS

Quick Start

Get started with OBSCURA Payment Systems in minutes. Follow these simple steps to integrate Solana blockchain payments into your application.

Installation

Install the OBSCURA SDK via npm or yarn:

npm install @obscura/payments-sdk

Basic Setup

import { ObscuraPayment } from '@obscura/payments-sdk';

const payment = new ObscuraPayment({
  apiKey: 'YOUR_API_KEY',
  network: 'mainnet-beta',
  environment: 'production'
});

// Initialize the payment system
await payment.initialize();

API Reference

Create Payment

Process a payment transaction on the Solana blockchain.

const transaction = await payment.createPayment({
  amount: 100.00,
  currency: 'USD',
  token: 'SOL',
  recipient: '7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU',
  metadata: {
    orderId: 'ORD-12345',
    customerId: 'CUST-67890'
  }
});

console.log('Transaction ID:', transaction.signature);
console.log('Status:', transaction.status);

Payment Parameters

Verify Transaction

Check the status of a transaction on the blockchain.

const status = await payment.verifyTransaction({
  signature: 'transaction_signature_here'
});

console.log('Status:', status.confirmed);
console.log('Confirmations:', status.confirmations);
console.log('Timestamp:', status.timestamp);

Webhooks

Configure webhooks to receive real-time notifications about payment events.

Setup Webhook Endpoint

await payment.configureWebhook({
  url: 'https://your-domain.com/webhooks/obscura',
  events: ['payment.completed', 'payment.failed', 'payment.pending'],
  secret: 'YOUR_WEBHOOK_SECRET'
});

Webhook Events

Security Best Practices

API Key Management

Store your API keys securely using environment variables:

// .env file
OBSCURA_API_KEY=your_api_key_here
OBSCURA_API_SECRET=your_api_secret_here

// In your code
const payment = new ObscuraPayment({
  apiKey: process.env.OBSCURA_API_KEY,
  apiSecret: process.env.OBSCURA_API_SECRET
});

Rate Limiting

Error Handling

Properly handle errors in your payment integration:

try {
  const transaction = await payment.createPayment({
    amount: 100.00,
    currency: 'USD',
    token: 'SOL',
    recipient: walletAddress
  });
  
  console.log('Payment successful:', transaction.signature);
  
} catch (error) {
  if (error.code === 'INSUFFICIENT_FUNDS') {
    console.error('Wallet has insufficient funds');
  } else if (error.code === 'INVALID_WALLET') {
    console.error('Invalid wallet address provided');
  } else if (error.code === 'NETWORK_ERROR') {
    console.error('Network connection issue');
  } else {
    console.error('Payment failed:', error.message);
  }
}

Common Error Codes

Support & Resources

Need help? We're here for you 24/7.

Overview

OBSCURA Payment Gateway is a comprehensive solution for accepting cryptocurrency payments on the Solana blockchain. Process payments in SOL, USDC, USDT, and other SPL tokens with lightning-fast confirmation times and minimal fees.

Key Features

Supported Tokens

Integration Methods

Choose the integration method that best fits your needs:

// Hosted Payment Page
const checkout = await gateway.createCheckout({
  amount: 99.99,
  currency: 'USD',
  returnUrl: 'https://yoursite.com/success'
});

window.location.href = checkout.url;

// API Integration
const payment = await gateway.processPayment({
  amount: 99.99,
  token: 'USDC',
  wallet: customerWalletAddress
});

// Payment Button Widget
<script src="https://cdn.obscura.pw/button.js"></script>
<button class="obscura-payment-button" data-amount="99.99">
  Pay with Crypto
</button>

Business Solutions

Comprehensive payment solutions designed for businesses of all sizes. From startups to enterprises, we provide the tools you need to accept cryptocurrency payments seamlessly.

Service Tiers

Additional Services

REST API

Our RESTful API provides complete control over payment processing, transaction management, and account operations.

Base URL

https://api.obscura.pw/v1/

Authentication

All API requests must include your API key in the Authorization header:

curl https://api.obscura.pw/v1/payments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Create Payment

POST /payments

curl -X POST https://api.obscura.pw/v1/payments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "100.00",
    "currency": "USD",
    "token": "USDC",
    "recipient": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "metadata": {
      "order_id": "ORD-123",
      "customer_email": "customer@example.com"
    }
  }'

Response

{
  "id": "pay_1234567890",
  "status": "pending",
  "amount": "100.00",
  "currency": "USD",
  "token": "USDC",
  "signature": "5Kp...[transaction signature]...9qL",
  "recipient": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "created_at": "2025-10-30T12:34:56Z",
  "confirmations": 0,
  "metadata": {
    "order_id": "ORD-123",
    "customer_email": "customer@example.com"
  }
}

Get Payment Status

GET /payments/{id}

curl https://api.obscura.pw/v1/payments/pay_1234567890 \
  -H "Authorization: Bearer YOUR_API_KEY"

List Payments

GET /payments

curl https://api.obscura.pw/v1/payments?limit=10&status=completed \
  -H "Authorization: Bearer YOUR_API_KEY"

SDKs Available

Enterprise-Grade Infrastructure

Built for scale, designed for reliability. Our enterprise solutions provide the performance, security, and support that large organizations demand.

Enterprise Features

Deployment Options

Volume Pricing

Custom pricing based on your transaction volume. The more you process, the lower your fees.

Complete API Endpoints

Payments

Wallets

Webhooks

Rate Limits

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1698742800

Getting Started

Complete guide for developers integrating OBSCURA payments into their applications.

Step 1: Create an Account

Sign up at https://dashboard.obscura.pw/signup and verify your email.

Step 2: Get API Keys

Navigate to Settings → API Keys and generate your keys:

• Test Mode: Use for development and testing
• Live Mode: Use for production transactions

Step 3: Install SDK

npm install @obscura/payments-sdk

Step 4: Initialize Client

import { ObscuraPayment } from '@obscura/payments-sdk';

const client = new ObscuraPayment({
  apiKey: process.env.OBSCURA_API_KEY,
  environment: 'testnet' // or 'mainnet' for production
});

await client.initialize();

Step 5: Create Your First Payment

const payment = await client.payments.create({
  amount: 50.00,
  currency: 'USD',
  token: 'USDC',
  recipient: 'customer_wallet_address',
  metadata: {
    orderId: 'ORD-123',
    customerEmail: 'customer@example.com'
  }
});

console.log('Payment created:', payment.id);
console.log('Transaction signature:', payment.signature);

Testing

Use these test wallets for development:

Test Wallet (Success): 7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU
Test Wallet (Failure): 11111111111111111111111111111111

Common Integration Patterns

// Express.js example
app.post('/checkout', async (req, res) => {
  const { cartTotal, customerWallet } = req.body;
  
  try {
    const payment = await client.payments.create({
      amount: cartTotal,
      currency: 'USD',
      token: 'USDC',
      recipient: customerWallet,
      metadata: {
        sessionId: req.session.id
      }
    });
    
    res.json({ success: true, paymentId: payment.id });
  } catch (error) {
    res.status(400).json({ error: error.message });
  }
});

// Create recurring payment
const subscription = await client.subscriptions.create({
  amount: 9.99,
  currency: 'USD',
  token: 'USDC',
  interval: 'month',
  customer: customerWallet
});

// Cancel subscription
await client.subscriptions.cancel(subscription.id);

app.post('/webhooks/obscura', async (req, res) => {
  const signature = req.headers['x-obscura-signature'];
  
  // Verify webhook signature
  const isValid = client.webhooks.verify(
    req.body,
    signature,
    process.env.WEBHOOK_SECRET
  );
  
  if (!isValid) {
    return res.status(401).send('Invalid signature');
  }
  
  const event = req.body;
  
  switch (event.type) {
    case 'payment.completed':
      // Handle successful payment
      await fulfillOrder(event.data.metadata.orderId);
      break;
    case 'payment.failed':
      // Handle failed payment
      await notifyCustomer(event.data.id);
      break;
  }
  
  res.status(200).send('OK');
});

How Can We Help?

Get support through multiple channels. Our team is available 24/7 to assist you.

FAQ - Frequently Asked Questions

Our Story

Founded in 2023, OBSCURA Payment Systems was born from a vision to make blockchain payments as simple and accessible as traditional payment methods. Our team of blockchain experts, payment industry veterans, and security specialists came together to build the most developer-friendly payment infrastructure on Solana.

Our Mission

To provide innovative payment solutions that protect businesses and ensure seamless transactions in a dynamic blockchain landscape.

Our Values

By The Numbers

Join Our Team

We're building the future of payments. Join our mission to make blockchain payments accessible to everyone.

Why Work at OBSCURA?

Open Positions

Get In Touch

Have a question or want to learn more? We'd love to hear from you.

Last Updated: October 30, 2025

Overview

OBSCURA Payment Systems ("we," "our," or "us") is committed to protecting your privacy. This Privacy Policy explains how we collect, use, disclose, and safeguard your information when you use our payment services.

Information We Collect

Personal Information:

• Name, email address, and contact information
• Business information and tax identification numbers
• Payment and transaction details
• Wallet addresses and cryptocurrency holdings

Technical Information:

• IP addresses and device information
• Browser type and operating system
• Usage data and analytics
• Cookies and tracking technologies

How We Use Your Information

• Process payments and transactions
• Verify identity and prevent fraud
• Provide customer support
• Comply with legal obligations
• Improve our services
• Send important updates and notifications

Data Security

We implement industry-leading security measures including:

• End-to-end encryption for all data transmission
• Multi-signature wallet security
• Regular security audits and penetration testing
• SOC 2 Type II compliance
• 24/7 security monitoring

Your Rights

You have the right to:

• Access your personal data
• Request correction of inaccurate data
• Request deletion of your data
• Object to data processing
• Export your data
• Withdraw consent at any time

Data Retention

We retain your information for as long as necessary to provide our services and comply with legal obligations. Transaction data is retained for 7 years for regulatory compliance.

International Transfers

Your data may be transferred to and processed in countries other than your own. We ensure appropriate safeguards are in place for such transfers.

Contact Us

For privacy-related questions or to exercise your rights, contact us at:

privacy@obscura.pw