@sdkrouter/payments 0.1.2

package/README.md

@@ -0,0 +1,122 @@
+# @sdkrouter/payments
+
+Accept crypto payments on your website with one React component. No payment processor, no merchant account, no monthly fees — payments go directly to your exchange account.
+
+## How it works
+
+1. Connect your exchange account (Binance, Bybit, OKX, KuCoin) in [sdkrouter.com](https://sdkrouter.com) dashboard
+2. Create a payment link (fixed or custom amount)
+3. Drop `<PaymentPage linkId="..." />` into your site
+4. Buyer clicks "Pay" → sees QR code + deposit address + exact USDT amount
+5. Buyer sends crypto from any wallet
+6. System detects the deposit automatically — no manual confirmation needed
+7. Funds appear in your exchange account
+
+**Zero platform fees.** You only pay standard network fees (e.g., ~$1 for TRC20).
+
+## Quick Start
+
+```bash
+npm install @sdkrouter/payments
+```
+
+### Full-page checkout
+
+```tsx
+import { PaymentPage } from '@sdkrouter/payments';
+
+<PaymentPage linkId="your-link-uuid" />
+```
+
+### Inline widget
+
+```tsx
+import { PaymentWidget } from '@sdkrouter/payments';
+
+<PaymentWidget linkId="abc-123" />
+```
+
+### Pay button with modal
+
+```tsx
+<PaymentWidget linkId="abc-123" mode="button" buttonText="Pay $50" />
+```
+
+## What the buyer sees
+
+| Step | Screen |
+|------|--------|
+| **1. Form** | Title, amount, email field |
+| **2. Payment** | QR code, deposit address (copy), exact amount (copy), 60-min countdown |
+| **3. Waiting** | "Checking for payment..." — auto-polls every 15 seconds |
+| **4. Confirmed** | "Payment Received!" with transaction ID |
+
+### Why the amount isn't round
+
+Each payment gets a unique amount (e.g., `10.003229 USDT` instead of `10.00`). This is how the system matches your deposit to your invoice on a shared address. The buyer copies the exact amount — it's handled automatically.
+
+## Features
+
+- **QR code** — SVG, scannable by any crypto wallet
+- **Copy buttons** — one-tap copy for address and amount
+- **Countdown timer** — 60-minute window, urgent indicator at <5 min
+- **Auto-detection** — polls for payment, no "I've paid" button needed
+- **Dark/light theme** — auto-detects from system/Tailwind/`data-theme`
+- **Self-contained** — CSS injected automatically, no external stylesheets
+- **React 18 & 19** — works with both
+
+## Custom UI
+
+```tsx
+import { PaymentProvider, usePayment } from '@sdkrouter/payments';
+
+<PaymentProvider linkId="abc-123">
+  <MyCheckout />
+</PaymentProvider>
+
+function MyCheckout() {
+  const { link, pay, paymentResult, isPaying, step, reset } = usePayment();
+
+  return (
+    <div>
+      <h1>{link?.title}</h1>
+      <button onClick={() => pay({ email: 'buyer@example.com' })} disabled={isPaying}>
+        Pay ${link?.amountUsd}
+      </button>
+      {paymentResult && (
+        <p>Send {paymentResult.payAmount} {paymentResult.coin} to {paymentResult.payAddress}</p>
+      )}
+    </div>
+  );
+}
+```
+
+## Props
+
+```ts
+interface PaymentLinkConfig {
+  linkId: string;                    // Payment link UUID from dashboard
+  baseUrl?: string;                  // API URL (default: https://api.sdkrouter.com)
+  customerId?: string;               // Your customer ID — enables payment history
+  projectSlug?: string;              // Your project slug
+  onSuccess?: (result) => void;      // Called when payment confirmed
+  onError?: (error: string) => void; // Called on error
+  theme?: 'light' | 'dark' | 'auto';
+  locale?: string;                   // 'en', 'ru', 'ko', etc.
+}
+```
+
+## Supported exchanges
+
+| Exchange | Networks | Sub-accounts |
+|----------|----------|-------------|
+| Binance | TRC20, ERC20, BEP20, Arbitrum, SOL | Up to 1000 |
+| Bybit | TRC20, ERC20, Arbitrum, SOL | Up to 100 |
+| OKX | TRC20, ERC20, Arbitrum, Polygon, SOL | Up to 50 |
+| KuCoin | TRC20, ERC20 | Up to 100 |
+
+Default network: **TRC20** (cheapest — ~$1 fee, fastest — ~3 seconds).
+
+## License
+
+MIT

package/dist/PaymentContent-BRE2P6SS.cjs

@@ -0,0 +1,14 @@
+"use client";
+'use strict';
+
+var chunk3W2GRACB_cjs = require('./chunk-3W2GRACB.cjs');
+require('./chunk-P3RGFDH4.cjs');
+
+
+
+Object.defineProperty(exports, "PaymentContent", {
+  enumerable: true,
+  get: function () { return chunk3W2GRACB_cjs.PaymentContent; }
+});
+//# sourceMappingURL=PaymentContent-BRE2P6SS.cjs.map
+//# sourceMappingURL=PaymentContent-BRE2P6SS.cjs.map

package/dist/PaymentContent-BRE2P6SS.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"PaymentContent-BRE2P6SS.cjs"}

package/dist/PaymentContent-HEOBMWSU.mjs

@@ -0,0 +1,5 @@
+"use client";
+export { PaymentContent } from './chunk-N3LT7RRW.mjs';
+import './chunk-4QQBPIIT.mjs';
+//# sourceMappingURL=PaymentContent-HEOBMWSU.mjs.map
+//# sourceMappingURL=PaymentContent-HEOBMWSU.mjs.map

package/dist/PaymentContent-HEOBMWSU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"PaymentContent-HEOBMWSU.mjs"}

package/dist/_api/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+require('../chunk-RSPZZ5K2.cjs');
+var chunkP3RGFDH4_cjs = require('../chunk-P3RGFDH4.cjs');
+
+
+
+Object.defineProperty(exports, "API", {
+  enumerable: true,
+  get: function () { return chunkP3RGFDH4_cjs.API; }
+});
+Object.defineProperty(exports, "Enums", {
+  enumerable: true,
+  get: function () { return chunkP3RGFDH4_cjs.enums_exports; }
+});
+Object.defineProperty(exports, "MemoryStorageAdapter", {
+  enumerable: true,
+  get: function () { return chunkP3RGFDH4_cjs.MemoryStorageAdapter; }
+});
+Object.defineProperty(exports, "PaymentsAPI", {
+  enumerable: true,
+  get: function () { return chunkP3RGFDH4_cjs.API; }
+});
+Object.defineProperty(exports, "createPaymentsApi", {
+  enumerable: true,
+  get: function () { return chunkP3RGFDH4_cjs.createPaymentsApi; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/_api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}