Overview

Choose Your Integration

Quick Start

npx yesallofus

WordPress / WooCommerce

https://yesallofus.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 YesAllofUs 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://yesallofus.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 YesAllofUs 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   │     │  YesAllofUs  │
│   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

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

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 Fee

Fee is calculated on commissions paid, not order total.

Referred stores get 50% fee discount in their first month (1.45% instead of 2.9%).

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