Overview

Choose Your Integration

Quick Start

npx soundbip

WordPress / WooCommerce

https://soundbip.com/plugin/YesAllofUs.zip

How It Works

1. 1Visitor arrives via yourstore.com/?ref=ABC123
2. 2Plugin stores ABC123 in a 30-day cookie
3. 3Visitor makes purchase, order status becomes "Completed"
4. 4Plugin calls SoundBip API with order details + referral code
5. 5Affiliate chain gets paid instantly in RLUSD (3-5 seconds)

Shortcodes

SDK Tracking

The SDK tracks referral codes only. Payouts are triggered securely from your backend. This is the recommended approach for non-WordPress platforms.

Add the Tracking Script

<script src="https://soundbip.com/js/track.js"></script>

Read the Referral Code

// Get the tracked referral code
const referralCode = window.YesAllofUs?.getReferralCode();

// Send to your backend with the order
fetch('/api/checkout', {
  method: 'POST',
  body: JSON.stringify({
    items: cart.items,
    total: cart.total,
    referral_code: referralCode  // Include this!
  })
});

What the SDK Does

• ✓ Captures ?ref=CODE from URL
• ✓ Stores in cookie for 30 days
• ✓ Falls back to sessionStorage
• ✓ Exposes YesAllofUs.getReferralCode()

Backend Integration

After payment is verified on your backend, call the SoundBip API to trigger affiliate payouts. This ensures payouts only happen for legitimate purchases.

Trigger Payout After Payment

// Your payment success handler
async function handlePaymentSuccess(order, referralCode) {
  // Only trigger if there's a referral
  if (!referralCode) return;
  
  const response = await fetch('https://api.dltpays.com/api/v1/payout', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'Bearer sk_your_api_secret'
    },
    body: JSON.stringify({
      order_id: order.id,
      order_total: order.total,
      referral_code: referralCode
    })
  });

  const result = await response.json();
  // { success: true, payout_id: "payout_abc123", status: "queued" }
}

Complete Flow Diagram

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│   Visitor    │     │  Your Site   │     │   SoundBip   │
│   Browser    │     │   Backend    │     │     API      │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       │  ?ref=ABC123       │                    │
       │───────────────────>│                    │
       │                    │                    │
       │  SDK stores cookie │                    │
       │<───────────────────│                    │
       │                    │                    │
       │  Checkout + pay    │                    │
       │───────────────────>│                    │
       │                    │                    │
       │                    │  POST /payout      │
       │                    │  + referral_code   │
       │                    │───────────────────>│
       │                    │                    │
       │                    │  { payout_id }     │
       │                    │<───────────────────│
       │                    │                    │
       │                    │    ┌───────────────┴──────────────┐
       │                    │    │  Affiliate receives RLUSD    │
       │                    │    │  in 3-5 seconds              │
       │                    │    └──────────────────────────────┘

Wallet Setup: Crossmark & Social Login

Connect your XRPL wallet to pay affiliates. Choose based on your preference:

Crossmark (Browser)

✓ Live

Connect via browser extension. Approve payouts with configurable limits.

• ✓ Browser extension — desktop
• ✓ Configurable daily limits
• ✓ Full control over your keys

S

Social Login (Web3Auth)

✓ Live

Sign in with Google, Apple, or email. No crypto wallet needed.

• ✓ No crypto knowledge required
• ✓ Wallet created automatically
• ✓ Non-custodial via MPC

Social Login (Web3Auth)

How It Works

Multi-Party Computation (MPC) Security

Pending Commissions System

24/7 Auto-Sign via SignerList

Social login wallets automatically add our platform as an authorized signer. This enables instant payouts without requiring the affiliate to be logged in.

// Automatically configured on wallet creation
{
  "TransactionType": "SignerListSet",
  "SignerQuorum": 1,
  "SignerEntries": [
    {
      "SignerEntry": {
        "Account": "rhaQVgnyk8svdknXwcghut9gBRnYrh4Wjp",  // SoundBip platform signer
        "SignerWeight": 1
      }
    }
  ]
}

Payout Modes

Auto-Sign Security

Auto-sign uses XRPL's native SignerList feature. You add our platform as an authorized signer with configurable limits. You can revoke anytime from your dashboard.

API: Payouts

API: Affiliates

API: Stores

Commission Rates

Affiliate Commissions (Default)

Rates are configurable in your dashboard. Total cannot exceed 100%.

Platform Fees

Simple, flat pricing — no tiers, no monthly costs.

No setup fees, no monthly minimums, no hidden charges.

Webhooks

Receive notifications when payout status changes. For WordPress, the plugin handles this automatically.

Webhook Payload

POST https://yoursite.com/webhooks/yesallofus
X-DLTPays-Signature: abc123...
Content-Type: application/json

{
  "payout_id": "payout_abc123",
  "status": "paid",
  "order_id": "order_12345",
  "tx_hashes": [
    {
      "wallet": "rAffiliate...",
      "amount": 25.00,
      "tx_hash": "ABC123DEF456..."
    }
  ]
}

Verify Signature

const crypto = require('crypto');

function verifyWebhook(payload, signature, apiSecret) {
  const expected = crypto
    .createHmac('sha256', apiSecret)
    .update(JSON.stringify(payload))
    .digest('hex');
  
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Error Codes

Support