5 dakikalık entegrasyon

Bir kripto ödeme oturumu oluşturun.

Barındırılan bir ödeme bağlantısı oluşturmak için ödeme oturumu API'sini kullanın. Aynı nesne sipariş kimliği, müşteri kimliği, ürün kodu, kupon bilgisi ve webhook geri çağırma ayrıntılarını taşıyabilir.

1. Oturum oluşturma isteğini gönderin

Zorunlu alanlar amount, currency ve network. Önce test anahtarlarını kullanın, mainnet açıldıktan sonra canlı anahtarlara geçin.

cURL

curl -X POST https://xpayr.com/api/v1/payments \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 49.90,
    "currency": "USDT",
    "network": "tron-mainnet",
    "is_multi_chain": true,
    "is_reusable": false,
    "send_invoice_email": true,
    "customer_email": "buyer@example.com",
    "metadata": {
      "order_id": "ORDER-1001",
      "customer_id": "cus_123"
    },
    "success_url": "https://example.com/paid",
    "cancel_url": "https://example.com/cancel",
    "ipn_callback_url": "https://example.com/webhooks/xpayr"
  }'

Node.js

const response = await fetch("https://xpayr.com/api/v1/payments", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.XPAYR_SECRET_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    amount: 49.90,
    currency: "USDT",
    network: "tron-mainnet",
    is_multi_chain: true,
    is_reusable: false,
    send_invoice_email: true,
    customer_email: "buyer@example.com",
    metadata: { order_id: "ORDER-1001", customer_id: "cus_123" },
    success_url: "https://example.com/paid",
    cancel_url: "https://example.com/cancel",
    ipn_callback_url: "https://example.com/webhooks/xpayr"
  })
});

const session = await response.json();
console.log(session.payment_url);

PHP

$payload = [
    'amount' => 49.90,
    'currency' => 'USDT',
    'network' => 'tron-mainnet',
    'is_multi_chain' => true,
    'is_reusable' => false,
    'send_invoice_email' => true,
    'customer_email' => 'buyer@example.com',
    'metadata' => ['order_id' => 'ORDER-1001', 'customer_id' => 'cus_123'],
    'success_url' => 'https://example.com/paid',
    'cancel_url' => 'https://example.com/cancel',
    'ipn_callback_url' => 'https://example.com/webhooks/xpayr',
];

$ch = curl_init('https://xpayr.com/api/v1/payments');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('XPAYR_SECRET_KEY'),
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode($payload),
]);

$session = json_decode(curl_exec($ch), true);
curl_close($ch);
echo $session['payment_url'] ?? 'No payment URL returned';

2. Dönen ödeme bağlantısına yönlendirin

{
  "id": "ps_abc123",
  "object": "payment_session",
  "amount": "49.90",
  "currency": "USDT",
  "network": "tron-mainnet",
  "status": "pending",
  "payment_url": "https://xpayr.com/test/ps_abc123",
  "livemode": false
}

3. Durumu doğrulayın

Hafif doğrulama için herkese açık durum uç noktasını, üretimdeki sipariş güncellemeleri için imzalı webhook'ları kullanın.

curl https://xpayr.com/api/v1/payments/ps_abc123/status

4. Hızlı başlangıç dosyalarını indirin

Resmi NPM SDK'ları (v0.2.0) ve Uzak MCP Sunucusu

Resmi XPayr Paketleri ve Kurulumsuz MCP ile Daha Hızlı Entegre Olun

Kurulum: @xpayr/node-sdk (v0.2.0), @xpayr/payment-evidence (v0.2.0), @xpayr/extension-kit (v0.2.0)veya @xpayr/mcp-server (v1.0.0) paketlerini NPM'den yükleyin veya şu araçla canlı JSON-RPC 2.0 çağrıları yürütün: POST https://xpayr.com/api/mcp.

Canlı MCP Oyun Alanı (/tools/mcp-playground) ES256 Lisans Doğrulayıcı YZ Ajan Politikası Simülatörü HMAC-SHA256 Webhook Test Aracı mcp.xpayr.com docs.xpayr.com api-docs.xpayr.com