اربط المحافظ على شبكة Testnet
سجّل عبر `/merchant/register`، واضبط عناوين EVM وTRON وSolana الخاصة بك، وأنشئ مفتاح `sk_test_...`.
انتقل إلى تسوية غير وصائية برسوم 0.5% خلال 15 دقيقة.
الانتقال بعيداً عن الأرصدة المحتجزة لدى الوسطاء أو الرسوم البالغة 1%–1.5% أو واجهات برمجة المتاجر المستضافة المتوقفة لا يتطلب إعادة كتابة قاعدة بيانات الطلبات لديك. طابق 4 حقول JSON، وتحقق من إشعارات ويب هوك HMAC-SHA256 الخام على شبكة Testnet، ووجّه 99.5% مباشرة إلى محافظك الخاصة.
10 أدلة تنفيذية مخصصة للانتقال من المزودين
اختر بوابتك الحالية للاطلاع على الفروقات الدقيقة لحقول JSON، ومحولات ويب هوك HMAC-SHA256، وأدلة الانتقال التدريجي المتوازي خلال 15 دقيقة.
انتقال في 12 دقيقة
افتح الدليل والكود البرمجي →
من NOWPayments
السابق: 0.5%–1.0% + رسوم التحويل وشبكة السحب
انتقال في 10 دقائق
افتح الدليل والكود البرمجي →
من Coinbase Commerce
السابق: رسوم بروتوكول 1.0% (مجموعة أصول وشبكات محدودة)
انتقال في 15 دقيقة
افتح الدليل والكود البرمجي →
من BitPay
السابق: 1.0%–2.0% + تكلفة الشبكة وتسوية T+1/T+2
انتقال في 15 دقيقة
افتح الدليل والكود البرمجي →
من BTCPay Server
السابق: $0 رسوم برمجية + $80–$350 شهرياً لصيانة VPS/RPC/DevOps
انتقال في 12 دقيقة
افتح الدليل والكود البرمجي →
من Cryptomus
السابق: 0.4%–2.0% + رسوم التحويل والسحب من الحفظ الوصائي
انتقال في 12 دقيقة
افتح الدليل والكود البرمجي →
من CoinGate
السابق: رسوم دفع ~1.0% + فروق أسعار الصرف والسحب
انتقال في 10 دقائق
افتح الدليل والكود البرمجي →
من Stripe Pay with Crypto
السابق: 1.5% لكل معاملة (أعلى بـ 3 أضعاف من XPayr)
انتقال في 15 دقيقة
افتح الدليل والكود البرمجي →
من CoinPayments
السابق: 0.5%–1.0% + رسوم تجميع العملات وشبكة السحب
انتقال في 10 دقائق
افتح الدليل والكود البرمجي →
من Helio (MoonPay Commerce)
السابق: 2.0% على الباقة المجانية أو اشتراك Pro بقيمة $299+/شهرياً + رسوم
انتقال في 15 دقيقة
افتح الدليل والكود البرمجي →
من Triple-A
السابق: ~1.0% + فارق تحويل العملات المؤسسي + تسوية مصرفية
NOWPayments IPN → محول XPayr API v1 وHMAC-SHA256
استبدل إشعارات `x-nowpayments-sig` المعتمدة على ترتيب المفاتيح وطوابير السحب الوصائي بالتحقق من النص الخام عبر `X-XPayr-Signature` والتسوية الفورية في محفظة التاجر.
| المفهوم | الآنالمدفوعات | المكافئ في XPayr |
|---|---|---|
| إنشاء جلسة | POST /v1/invoice (x-api-key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| المبلغ ومرجع الطلب | price_amount, price_currency, order_id | amount, currency, order_id, metadata |
| توقيع الويب هوك | x-nowpayments-sig (HMAC-SHA512 لكائن JSON مرتب) | X-XPayr-Signature (HMAC-SHA256 على النص الخام — دون أي أخطاء ترتيب مفاتيح JSON) |
| حالات إتمام الطلب | finished / partially_paid | payment.completed / payment.underpaid_accepted (تسامح 1%) |
// Drop-in Node.js Express webhook adapter (XPayr raw-body HMAC-SHA256)
import crypto from 'node:crypto';
export function verifyXpayrWebhook(rawBodyBuffer, signatureHeader, webhookSecret) {
const expected = crypto.createHmac('sha256', webhookSecret).update(rawBodyBuffer).digest('hex');
const provided = String(signatureHeader || '').replace(/^sha256=/i, '');
if (expected.length !== provided.length) return false;
return crypto.timingSafeEqual(Buffer.from(expected, 'utf8'), Buffer.from(provided, 'utf8'));
}
رسوم Coinbase Commerce → جلسات الدفع المزدوج في XPayr
استعد دعم TRON TRC-20 USDT وتحويلات رمز QR من المنصات والتوافر العالمي للتجار مع الحفاظ على دلالات `metadata` و`hosted_url` المألوفة.
| المفهوم | Coinbase Commerce | المكافئ في XPayr |
|---|---|---|
| إنشاء عملية دفع | POST /charges (X-CC-Api-Key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| نوع التسعير | local_price.amount + pricing_type: fixed_price | amount + currency: "USD" |
| إعادة التوجيه المستضافة | data.hosted_url | data.checkout_url (يدعم حزمة Modal SDK أو إعادة التوجيه الكاملة) |
| حدث Webhook | charge:confirmed / charge:resolved | payment.completed / payment.underpaid_accepted |
// Replace Coinbase Charge creation with @xpayr/node-sdk (v0.2.0)
import { XPayrClient } from '@xpayr/node-sdk';
const xpayr = new XPayrClient({ apiKey: process.env.XPAYR_SECRET_KEY });
const session = await xpayr.payments.create({
amount: '49.00',
currency: 'USD',
order_id: 'ord_90812',
success_url: 'https://app.example.com/billing/success',
metadata: { workspace_id: 'ws_441', plan: 'pro_annual' }
});
BitPay / CoinGate (وصائي 1%–2%) → XPayr (مباشر للمحفظة 0.5%)
خفّض رسوم بوابة الدفع بنسبة 50%–75% وتخلّص من دفعات التسوية المصرفية الوصائية T+2 عبر استلام USDT/USDC الأصلي مباشرة في محفظتك متعددة التوقيعات أو محفظتك الباردة.
| المفهوم | BitPay وCoinGate | المكافئ في XPayr |
|---|---|---|
| رسوم الدفع | 1.0%–2.0% + قواعد التسوية وصرف العملات | ثابتة 0.5% (50 نقطة أساس)، $0 شهرياً، $0 احتياطي متجدد |
| إضافات التجارة الإلكترونية | وحدات سلة التسوق الوصائية القديمة | 6 إضافات مفتوحة المصدر بالإصدار v1.0.0 عبر /integrations |
| التحقق من الإشعارات الراجعة | رمز غير موثّق أو يتطلب استعلاماً عكسياً للتحقق | تشفيري X-XPayr-Signature + @xpayr/payment-evidence |
| مخرجات الخزينة | محتجز في رصيد المزود حتى موعد السحب | تحويل فوري على الشبكة بنسبة 99.5% إلى محفظتك |
# Verify live XPayr session creation in 5 seconds via cURL:
curl -sS -X POST https://xpayr.com/api/v1/payments \
-H "Authorization: Bearer sk_test_your_key" \
-H "Content-Type: application/json" \
-d '{"amount":"100.00","currency":"USD","order_id":"mig_test_01","network":"tron","token":"USDT"}'
أضف XPayr بجانب Stripe (0.5% للعملات الرقمية عالمياً مقابل 1.5% في Stripe Crypto)
احتفظ بـ Stripe للبطاقات المحلية إذا رغبت، وأضف XPayr كزر عالمي لـ الدفع بالعملات الرقمية (0.5%) لإتاحة TRON TRC-20 USDT وSolana والاحتفاظ بالعملات المستقرة الأصلية في أكثر من 180 سوقاً.
| المعيار | الدفع بالعملات الرقمية عبر Stripe | مسار الدفع الرقمي المتوازي من XPayr |
|---|---|---|
| رسوم العملات المستقرة | 1.5% لكل معاملة | ثابتة 0.5% (وفّر 66% في كل طلب عملات رقمية) |
| TRON TRC-20 ورمز QR من المنصات | غير مدعوم | دعم كامل لـ TRON TRC-20 USDT + رمز QR من المنصات |
| أصل الخزينة | يُحوَّل تلقائياً إلى رصيد مصرفي بالعملات النقدية | احتفظ بعملات USDC/USDT الأصلية في محفظة خزينتك الخاصة |
| أتمتة الذكاء الاصطناعي وMCP | أدوات وكلاء متمحورة حول العملات التقليدية | خادم MCP يضم 21 أداة (/api/mcp) + جدران دفع HTTP 402 (/x402) |
<!-- Embed alongside Stripe Checkout on any pricing or cart page -->
<script src="https://xpayr.com/public/sdk/xpayr-pay-button.js" defer></script>
<div data-xpayr-pay-button
data-amount="99.00"
data-currency="USD"
data-label="Pay with USDT / USDC (Save FX Fees)"></div>
تحقق من توافق إشعارات الويب هوك
حاكِ توقيعات `payment.completed` و`payment.underpaid_accepted` عبر `/tools/webhook-tester` قبل النشر الحي.
اختبار تدريجي لـ 10% من حركة الدفع
اعرض XPayr بجانب الزر أو الإضافة القديمة لديك حتى يقوم العملاء الفعليون بتسوية 99.5% مباشرة إلى محفظتك.
طابق الحسابات وانتقل بنسبة 100%
صدّر دفاتر CSV المتوافقة مع QuickBooks/Xero/NetSuite (`/accounting`) واستغنِ نهائياً عن الأرصدة الوصائية ذات الرسوم المرتفعة.
الأسئلة الشائعة — الانتقال إلى XPayr
هل يمكننا تشغيل XPayr بالتوازي مع بوابتنا الحالية قبل الانتقال الكامل؟
نعم. نظراً لأن XPayr تفرض رسوماً شهرية بقيمة $0 ولا تشترط أي التزام حصري، يقوم معظم فرق الهندسة بنشر XPayr على شبكة الاختبار (Testnet) أولاً، ثم توجيه 10%–25% من حركة الدفع الحي بالعملات الرقمية إلى XPayr مع التحقق من تطابق الويب هوك وتسوية 99.5% مباشرة إلى المحفظة.
كيف تتطابق إشعارات NOWPayments IPN مع ويب هوك XPayr؟
ترسل NOWPayments ترويسة x-nowpayments-sig (بتوقيع HMAC-SHA512 لكائن JSON مرتب) مع حالات مثل finished وpartially_paid. بينما ترسل XPayr ترويسة X-XPayr-Signature (بتوقيع HMAC-SHA256 على النص الخام مع حماية الطابع الزمني ضد إعادة الإرسال) مع أحداث حتمية: payment.completed وpayment.underpaid_accepted وpayment.failed وlicense.issued.
ماذا يحدث لمتاجر WooCommerce أو Magento 2 أو PrestaShop أو Shopware الحالية؟
ثبّت إضافة XPayr الرسمية مفتوحة المصدر بجانب إضافة البوابة الحالية لديك (/integrations)، والصق مفتاح API الخاص بشبكة Testnet للتحقق من انتقالات حالة الطلب، ثم بدّل طريقة الدفع النشطة بنقرة واحدة.
هل يتعين علينا نقل الأرصدة المحتجزة من مزود الدفع القديم أولاً؟
لا. اسحب أي رصيد متبقٍ من مزود الدفع الوصائي القديم وفق جدولك الزمني الخاص؛ فكل دفعة جديدة عبر XPayr تُسوّى بنسبة 99.5% مباشرة إلى محفظتك الخاصة فور تأكيد المعاملة.