Nano Payment Integration Guide

Simple Link

<a href="https://bitrequest.github.io/?p=home&payment=nano&uoa=usd&amount=1&address=YOUR_NANO_ADDRESS">
    Pay 1 USD in Nano
</a>
                    

Intermediate Implementation

<script>
// Configuration for the payment request
function createBitRequest() {
    const payment = "nano";
    const uoa = "usd";
    const amount = 0.05;
    const address = "YOUR_NANO_ADDRESS";
    const d = btoa(JSON.stringify({
        "t": "Payment Request",
        "n": "Store Payment",
        "c": 0
    }));
    return "https://bitrequest.github.io/?payment=" + payment + "&uoa=" + uoa + "&amount=" + amount + "&address=" + address + "&d=" + d;
}

// Example usage
const paymentUrl = createBitRequest();
window.location.href = paymentUrl;
</script>
                    

Advanced Implementation

For the complete advanced implementation with features like Lightning Network support, webhooks, and shopping cart integration, check out the official BitRequest Webshop Integration Guide.

<script src="https://pay.nano.to/latest.js"></script>

<button onclick="payWithNanoTo()">Pay Now</button>

<script>
function payWithNanoTo() {
    NanoPay.open({ 
        title: "Demo Payment",
        address: '@your-username', 
        amount: 0.1,
        notify: 'your@email.com',
        contact: true,
        shipping: {
            onShippingUpdate: function(details) {
                console.log('Shipping details:', details);
                return true;
            }
        },
        currency: 'USD',
        wallet: 'natrium',
        success: (block) => {
            console.log('Payment successful!', {
                hash: block.hash,
                amount: block.amount,
                email: block.email,
                shipping: block.shipping
            });
        }
    });
}
</script>
                

Create Deposit Address

// Create a deposit address
async function createDeposit(apiKey, privateKey, currency) {
    const timestamp = Date.now();
    const body = JSON.stringify({
        currency: currency,
        time: timestamp
    });
    
    // Create signature
    const signature = CryptoJS.HmacSHA256(body, privateKey).toString(CryptoJS.enc.Base64);
    
    const response = await fetch('https://nanpay.pilou.cc/wallet/deposit', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'auth': apiKey,
            'sign': signature
        },
        body: body
    });
    
    const data = await response.json();
    return data.address; // Returns managed deposit address
}

Create Withdrawal

// Create a withdrawal
async function createWithdrawal(apiKey, privateKey, currency, amount, destination) {
    const timestamp = Date.now();
    const body = JSON.stringify({
        currency: currency,
        time: timestamp,
        amount: amount,
        destination: destination
    });
    
    // Create signature
    const signature = CryptoJS.HmacSHA256(body, privateKey).toString(CryptoJS.enc.Base64);
    
    const response = await fetch('https://nanpay.pilou.cc/wallet/withdraw', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json',
            'auth': apiKey,
            'sign': signature
        },
        body: body
    });
    
    return await response.json();
}

Simple Implementation

// Create payment URL and redirect
function createNanoPayment(address, amount, title, redirectUrl) {
    const params = new URLSearchParams({
        address: address,
        amount: amount
    });
    
    if (title) params.append('title', title);
    if (redirectUrl) params.append('redirect_url', redirectUrl);
    
    const paymentUrl = `https://nanopay.me/payment?${params}`;
    window.location.href = paymentUrl;
}

API Implementation (Backend Required)

// Server-side implementation example
async function createInvoice(apiKey, paymentData) {
    const response = await fetch('https://api.nanopay.me/invoices', {
        method: 'POST',
        headers: {
            'Authorization': `Bearer ${apiKey}`,
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            title: paymentData.title,
            price: paymentData.amount,
            recipient_address: paymentData.address,
            redirect_url: paymentData.redirect_url
        })
    });
 
    return await response.json();
 }

Simple Implementation

// Create a basic invoice with a single recipient
async function createSplitRouteInvoice(apiKey, amount, address) {
  const response = await fetch('https://api.splitroute.com/api/v1/invoices', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': apiKey
    },
    body: JSON.stringify({
      nominal_amount: amount,
      nominal_currency: 'USD',
      destinations: [
        {
          account: address,
          primary: true
        }
      ],
      show_qr: true
    })
  });
  
  return await response.json();
}

Split Payment Implementation

// Create an invoice with payment splitting
async function createSplitPaymentInvoice(apiKey, amount, primaryAddress, partnerAddress, partnerPercentage) {
  const response = await fetch('https://api.splitroute.com/api/v1/invoices', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'X-API-Key': apiKey
    },
    body: JSON.stringify({
      nominal_amount: amount,
      nominal_currency: 'USD',
      destinations: [
        {
          account: primaryAddress,
          primary: true,
          description: "Main recipient"
        },
        {
          account: partnerAddress,
          percentage: partnerPercentage,
          description: `Partner fee (${partnerPercentage}%)`
        }
      ],
      show_qr: true
    })
  });
  
  return await response.json();
}

// Monitor payment status with WebSocket
function monitorPayment(invoiceId) {
  const socket = new WebSocket(`wss://api.splitroute.com/api/v1/ws/invoices/${invoiceId}`);
  
  socket.onopen = function(e) {
    console.log('Connected to WebSocket');
  };
  
  socket.onmessage = function(event) {
    const message = JSON.parse(event.data);
    
    // Handle different event types
    if (message.payload.event_type === 'invoice.paid') {
      console.log('Invoice has been paid!');
      console.log(`Amount received: ${message.payload.formatted_amount}`);
      // Update your UI or take other actions
    }
    
    // Check for invoice completion
    if (message.category === 'completed') {
      console.log('Invoice processing completed');
      socket.close();
    }
  };
  
  return socket;
}

Advanced Implementation

For the complete advanced implementation with features like multiple recipients, webhooks, and more, check out the official SplitRoute API Documentation.