Mutabakat Hassasiyeti ve Uç Senaryolar
Eksik ve Fazla Ödenen Kripto Ödemelerin Yönetimi
Müşteriler merkezi borsalardan (Binance, OKX, Coinbase) ödeme yaptığında, borsa genellikle gönderilen tutardan $0.80–$1.00 ağ çekim ücreti düşer. XPayr'ın tolerans motorunun ve webhook durumlarının bu uç senaryo mutabakatını nasıl otomatikleştirdiğini öğrenin.
1. Üç Deterministik Mutabakat Sonucu
| Senaryo | Webhook Olayı | Ödeme Geçidi ve Akıllı Sözleşme Davranışı |
|---|---|---|
| Tolerans Dahilinde Eksik Ödeme (örn. $100 yerine $99) | payment.underpaid_accepted |
Eksik tutar yapılandırdığınız tolerans eşiği (örn. %1–%2) içinde kaldığında otomatik kabul edilir. Sabit 0.5% komisyonla aktarır fiili alınan tutar üzerinden hesaplanır. |
| Tolerans Dışı Eksik Ödeme (Kısmi Ödeme) | payment.partial_pending |
Ödeme arayüzü kalan net farkı gerçek zamanlı gösterir; böylece alıcı oturum süresi dolmadan ikinci bir tamamlama işlemi gönderebilir ya da üye iş yeri Kontrol Paneli'nden ödemeyi manuel kabul edebilir. |
| Fazla Ödenen Mutabakat (örn. $100 yerine $105) | payment.completed (overpaid_delta > 0) |
Sipariş anında tamamlandı olarak işaretlenir; tam overpaid_amount değeri, müşterinin hesap bakiyesine alacak kaydedebilmeniz için webhook verisine ve ödeme kanıt paketine işlenir. |
2. Örnek `payment.underpaid_accepted` Webhook Verisi
Bu olayı birebir simüle edebilir ve HMAC-SHA256 imza başlıklarını canlı olarak şu araçta inceleyebilirsiniz: Etkileşimli Webhook Test Aracı:
{
"event": "payment.underpaid_accepted",
"event_id": "evt_01J9XPAYR_UNDERPAID_89A2",
"created_at": "2026-11-10T18:00:00Z",
"data": {
"session_id": "cs_live_98a7b6c5d4e3",
"order_id": "ORD-2026-8841",
"network": "tron-mainnet",
"currency": "USDT",
"expected_amount": "100.000000",
"received_amount": "99.000000",
"shortfall_amount": "1.000000",
"shortfall_percent": 1.0,
"merchant_tolerance_percent": 1.5,
"gateway_fee_amount": "0.495000",
"merchant_net_amount": "98.505000",
"tx_hash": "0x9f8e7d6c5b4a3f2e1d0c9b8a7f6e5d4c3b2a1f0e9d8c7b6a5f4e3d2c1b0a9f8e",
"resolution": "auto_accepted_within_tolerance"
}
}3. Node.js ile Eksik ve Fazla Ödeme Kanıtlarını Doğrulama
// Verify underpaid/completed settlement evidence with @xpayr/payment-evidence (v0.2.0)
import { verifyPaymentEvidence } from "@xpayr/payment-evidence";
const verification = await verifyPaymentEvidence(webhookPayload, {
webhookSecret: process.env.XPAYR_WEBHOOK_SECRET,
signatureHeader: req.headers["x-xpayr-signature"],
allowUnderpaidWithinTolerance: true
});
if (verification.valid) {
await fulfillOrder(webhookPayload.data.order_id, {
receivedAmount: webhookPayload.data.received_amount,
txHash: webhookPayload.data.tx_hash
});
}
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.