معالجة مدفوعات العملات الرقمية الناقصة والزائدة

1. ثلاث نتائج تسوية حتمية

2. نموذج حمولة Webhook للحدث `payment.underpaid_accepted`

يمكنك محاكاة هذا الحدث بالضبط وفحص ترويسات توقيع HMAC-SHA256 مباشرةً في أداة اختبار Webhook التفاعلية:

{
  "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

// 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
  });
}