Connectez vos portefeuilles sur Testnet
Inscrivez-vous sur `/merchant/register`, configurez vos adresses EVM, TRON et Solana, puis générez une clé `sk_test_...`.
Migrez vers un règlement non-custodial à 0.5% en 15 minutes.
Quitter les soldes retenus par un processeur, les frais de 1% à 1.5% ou les API e-commerce hébergées obsolètes ne nécessite pas de réécrire votre base de données de commandes. Associez 4 champs JSON, vérifiez les webhooks HMAC-SHA256 sur corps brut en Testnet et acheminez 99.5% directement vers vos propres portefeuilles.
10 guides pratiques dédiés de migration par prestataire
Sélectionnez votre passerelle actuelle pour obtenir les différences exactes de champs JSON, les adaptateurs webhook HMAC-SHA256 et les guides de bascule canary parallèle en 15 minutes.
Bascule en 12 minutes
Ouvrir le guide et le code →
Depuis NOWPayments
Ancien : 0.5%–1.0% + frais de conversion et réseau de retrait
Bascule en 10 minutes
Ouvrir le guide et le code →
Depuis Coinbase Commerce
Ancien : frais de protocole de 1.0% (liste restreinte d'actifs et réseaux)
Bascule en 15 minutes
Ouvrir le guide et le code →
Depuis BitPay
Ancien : 1.0%–2.0% + coût réseau et règlement J+1/J+2
Bascule en 15 minutes
Ouvrir le guide et le code →
Depuis BTCPay Server
Ancien : $0 de frais logiciels + $80–$350/mois de maintenance VPS/RPC/DevOps
Bascule en 12 minutes
Ouvrir le guide et le code →
Depuis Cryptomus
Ancien : 0.4%–2.0% + frais de conversion et de retrait dépositaire
Bascule en 12 minutes
Ouvrir le guide et le code →
Depuis CoinGate
Ancien : ~1.0% de frais de paiement + spreads de change et de versement
Bascule en 10 minutes
Ouvrir le guide et le code →
Depuis Stripe Pay with Crypto
Ancien : 1.5% par transaction (3x plus élevé que XPayr)
Bascule en 15 minutes
Ouvrir le guide et le code →
Depuis CoinPayments
Ancien : 0.5%–1.0% + frais de regroupement (sweeping) et réseau de retrait
Bascule en 10 minutes
Ouvrir le guide et le code →
Depuis Helio (MoonPay Commerce)
Ancien : 2.0% sur l'offre gratuite ou abonnement Pro à $299+/mois + frais
Bascule en 15 minutes
Ouvrir le guide et le code →
Depuis Triple-A
Ancien : ~1.0% + spread de change institutionnel + règlement bancaire
NOWPayments IPN → Adaptateur XPayr API v1 et HMAC-SHA256
Remplacez les callbacks `x-nowpayments-sig` à clés triées et les files de versement dépositaires par la vérification sur corps brut `X-XPayr-Signature` et le règlement instantané vers le portefeuille marchand.
| Concept | MAINTENANTPaiements | Équivalent XPayr |
|---|---|---|
| Créer une session | POST /v1/invoice (x-api-key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| Montant et réf. commande | price_amount, price_currency, order_id | amount, currency, order_id, metadata |
| Signature du webhook | x-nowpayments-sig (HMAC-SHA512 sur JSON trié) | X-XPayr-Signature (HMAC-SHA256 sur corps brut — zéro bug de tri de clés JSON) |
| États d'exécution | finished / partially_paid | payment.completed / payment.underpaid_accepted (tolérance de 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'));
}
Charges Coinbase Commerce → Sessions Dual Checkout XPayr
Rétablissez l'USDT TRC-20 sur TRON, les transferts QR d'exchanges et la disponibilité marchande mondiale tout en conservant la sémantique familière de `metadata` et `hosted_url`.
| Concept | Coinbase Commerce | Équivalent XPayr |
|---|---|---|
| Créer un paiement | POST /charges (X-CC-Api-Key) | POST /api/v1/payments (Authorization: Bearer sk_live_...) |
| Type de tarification | local_price.amount + pricing_type: fixed_price | amount + currency: "USD" |
| Redirection hébergée | data.hosted_url | data.checkout_url (prend en charge le SDK Modal ou la redirection complète) |
| Événement 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% dépositaire) → XPayr (0.5% portefeuille direct)
Réduisez vos frais de passerelle de 50% à 75% et éliminez les lots de règlement bancaire dépositaire à J+2 en recevant directement des USDT/USDC natifs sur votre portefeuille multisig ou matériel.
| Concept | BitPay et CoinGate | Équivalent XPayr |
|---|---|---|
| Frais de paiement | 1.0%–2.0% + règles de règlement et de change | Fixe 0.5% (50 pdb), $0/mois, $0 réserve glissante |
| Extensions e-commerce | Modules panier dépositaires historiques | 6 extensions open-source v1.0.0 sur /integrations |
| Vérification des callbacks | Jeton non authentifié ou requête de contrôle requise | Cryptographique X-XPayr-Signature + @xpayr/payment-evidence |
| Sortie de trésorerie | Retenu sur le solde du processeur jusqu'au versement | Transfert on-chain immédiat de 99.5% vers votre portefeuille |
# 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"}'
Ajoutez XPayr en complément de Stripe (0.5% crypto mondial contre 1.5% Stripe Crypto)
Conservez Stripe pour les cartes domestiques si vous le souhaitez, et ajoutez XPayr comme bouton mondial Payer en crypto (0.5%) pour débloquer l'USDT TRC-20 sur TRON, Solana et la conservation native de stablecoins dans plus de 180 marchés.
| Critère | Paiement crypto Stripe | Rail crypto parallèle XPayr |
|---|---|---|
| Frais sur stablecoins | 1.5% par transaction | Fixe 0.5% (économisez 66% sur chaque commande crypto) |
| TRON TRC-20 et QR d'exchanges | Non pris en charge | Prise en charge complète TRON TRC-20 USDT + QR d'exchanges |
| Actif de trésorerie | Converti automatiquement en solde bancaire fiat | Conservez des USDC/USDT natifs dans votre portefeuille de trésorerie |
| Automatisation IA et MCP | Outils d'agents centrés sur le fiat | Serveur MCP à 21 outils (/api/mcp) + paywalls 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>
Validez la parité des webhooks
Simulez les signatures `payment.completed` et `payment.underpaid_accepted` dans `/tools/webhook-tester` avant la mise en production.
Déploiement canary sur 10% du trafic de paiement
Affichez XPayr à côté de votre bouton ou module existant afin que vos clients règlent 99.5% directement sur votre portefeuille.
Rapprochez et basculez à 100%
Exportez vos journaux CSV QuickBooks/Xero/NetSuite (`/accounting`) et abandonnez définitivement les soldes dépositaires à frais élevés.
Foire aux questions — Migrer vers XPayr
Pouvons-nous exécuter XPayr en parallèle avec notre passerelle existante avant la bascule complète ?
Oui. Comme XPayr facture $0 de frais mensuels et n'impose aucune clause d'exclusivité, la plupart des équipes techniques déploient d'abord XPayr sur Testnet, puis orientent 10% à 25% du trafic de paiement crypto réel vers XPayr tout en vérifiant la parité des webhooks et le règlement direct de 99.5% vers le portefeuille.
Comment les callbacks IPN de NOWPayments correspondent-ils aux webhooks XPayr ?
NOWPayments envoie x-nowpayments-sig (HMAC-SHA512 sur JSON trié) avec des statuts tels que finished et partially_paid. XPayr envoie X-XPayr-Signature (HMAC-SHA256 sur corps brut avec protection anti-rejeu par horodatage) avec des événements déterministes : payment.completed, payment.underpaid_accepted, payment.failed et license.issued.
Qu'advient-il des boutiques WooCommerce, Magento 2, PrestaShop ou Shopware existantes ?
Installez l'extension officielle open-source XPayr à côté de votre module de passerelle actuel (/integrations), collez votre clé API Testnet pour vérifier les changements d'état de commande, puis basculez le mode de paiement actif en un clic.
Devons-nous d'abord transférer les soldes dépositaires hors de notre ancien processeur ?
Non. Retirez simplement tout solde restant auprès de votre ancien processeur dépositaire à votre rythme ; chaque nouveau paiement XPayr règle 99.5% directement sur votre propre portefeuille dès confirmation.