SellvyPay SDK
SellvyPay enables direct cryptocurrency payments with zero processing fees. Payments go straight to your wallet — no intermediary, no custodial accounts.
Supported currencies
How it works
SellvyPay uses two methods depending on the cryptocurrency:
HD Derivation (BTC, LTC, DOGE)
You provide your wallet's extended public key (zpub). For each payment, Sellvy derives a unique child address from your zpub. The customer sends payment to this unique address, and funds arrive directly in your wallet. No private keys are ever shared.
Dust Matching (ETH, USDT, USDC)
The customer sends a slightly modified amount (e.g., $29.97 instead of $30.00) to your wallet address. The unique dust amount maps the transaction to the specific order. This avoids the need for a unique address per payment.
Setup
- 1Go to Settings → Payments → SellvyPay in your dashboard.
- 2For BTC/LTC/DOGE: Enter your wallet's extended public key (zpub/xpub). For ETH/USDT/USDC: Enter your wallet address.
- 3Enable the currencies you want to accept and save your settings.
- 4Customers will see crypto payment options at checkout automatically.
API integration
If you want to create crypto payment sessions programmatically (for custom checkout flows), use the SellvyPay API:
// Create a crypto payment session
const res = await fetch("https://api.sellvy.io/v1/payments/crypto/create", {
method: "POST",
headers: {
"Authorization": "Bearer sk_live_...",
"Content-Type": "application/json"
},
body: JSON.stringify({
product_id: "prod_abc123",
currency: "BTC",
email: "customer@example.com",
return_url: "https://yoursite.com/thank-you"
})
});
const session = await res.json();
console.log(session.payment_address); // Unique BTC address
console.log(session.amount_crypto); // Amount in BTC
console.log(session.expires_at); // Session expiry (30 min)Check payment status
Poll the session status or use webhooks to receive notifications when payment is confirmed:
// Poll payment status
const res = await fetch(
"https://api.sellvy.io/v1/payments/crypto/session_abc123",
{ headers: { "Authorization": "Bearer sk_live_..." } }
);
const session = await res.json();
console.log(session.status);
// "waiting" — Waiting for payment
// "confirming" — Transaction detected, waiting for confirmations
// "completed" — Payment confirmed, order fulfilled
// "expired" — Session expired without paymentPlatform fees
SellvyPay itself has zero processing fees. However, Sellvy platform fees still apply based on your plan:
| Plan | Platform fee | Deducted from |
|---|---|---|
| Free | 5% | Prepaid fee balance |
| Pro | 2% | Prepaid fee balance |
| Business | 0% | N/A |
For crypto-only sellers on Free or Pro plans, fees are deducted from your prepaid fee balance (topped up from your dashboard).