الدفعة المجمعة (تحصيل التاجر برقم البطاقة)

مثال: "1000000" هو 1 USDT عندما تكون الكسور العشرية = 6. استبدل جميع العناصر النائبة بتفاصيل المستلم والأداة التي تم التحقق منها. يمكن أن يؤدي إرسال هذا الطلب إلى نقل أموال حقيقية. مراجعة العملية والتصريح بها صراحة قبل تقديمها. راجع البدء السريع.

يمكّن نوع المعاملة هذا مجمع خدمة الدفع من قبول مدفوعات العملاء نيابة عن تاجر متكامل. يتم خصم الأموال من الدافع وتوزيعها بين التاجر (صافي رسوم المجمع) والمجمع (جزء الرسوم) تلقائيًا.

سير الأعمال

1. التاجر يوقع اتفاقية / انضمام مع المجمع.
2. يقوم المجمع بإرشاد التاجر لإنشاء (أو توفير) محفظة في نظام heth.me وإرسال wallet_id مرة أخرى.
3. باستخدام مفتاح API الخاص به، يقوم المجمع بإنشاء معاملة دفع تحدد تفاصيل محفظة التاجر في money_storage_merchant وتفاصيل بطاقة الدافع في money_storage.
4. عند نجاح المعالجة، يتم تحديث أرصدة الدافع والتاجر والمجمع في خطوة واحدة.
5. يمكن استقصاء حالة المعاملة باستخدام طريقة استرجاع المعاملة القياسية (معتمدة بنفس مفتاح API).

نموذج طلب

curl --location --request POST 'https://app.heth.me/api/v1/transactions' \
  --header 'Content-Type: application/json' \
  --header "x-api-key: $HETH_API_KEY" \
  --data '{
    "params": {
      "amount": "1000000",
      "currency": "USDT",
      "env": "prod",
      "type": "payment",
      "route": "hot_hot_ETH",
      "money_storage_merchant": {
        "wallet_id": "YOUR_WALLET_ID",
        "network": "ETH",
        "type": "p2p_proxy",
        "currency": "USDT"
      },
      "money_storage": {
        "network": "ETH",
        "type": "bank_card",
        "currency": "USDT",
        "cardnumber": "YOUR_CARD_NUMBER",
        "cvv": "YOUR_CVV",
        "exp_month": "08",
        "exp_year": "2026",
        "cardholder": "John Doe"
      },
      "description": "Payment",
      "txid": "d9428888-122b-41e1-b85c-61cb3f548aa7"
    }
  }'

مرجع ميداني

المجال	الوصف	اكتب	مثال
amount	مبلغ المعاملة (سلسلة من عدد صحيح في وحدات ثانوية)	String	1000000
currency	عملة المعاملة (الافتراضية USDT)	String	USDT
env	prod (افتراضي). الحفاظ على هذه القيمة عند فتح الطلب وتأكيده.	String	prod
type	نوع المعاملة (الدفع)	String	payment
route	مسار المعالجة (يجب أن يتطابق مع التعيين الذي تم تكوينه)	String	hot_hot_ETH
money_storage_merchant	واصف محفظة التاجر (المدفوع لأمره)	Object
> wallet_id	معرف محفظة التاجر	String	YOUR_WALLET_ID
> network	شبكة البلوكشين (TRX أو ETH)	String	ETH
> type	نوع تفاعل المحفظة (على سبيل المثال، p2p_proxy)	String	p2p_proxy
> currency	عملة تسوية التاجر (الافتراضي USDT)	String	USDT
money_storage	واصف أداة تمويل الدافع	Object
> network	شبكة البلوكشين (TRX أو ETH)	String	ETH
> type	نوع الأداة (bank_card)	String	bank_card
> currency	عملة الدافع (الافتراضية USDT)	String	USDT
> cardnumber	رقم البطاقة الافتراضية	String	YOUR_CARD_NUMBER
> cvv	البطاقة الافتراضية CVV	String	YOUR_CVV
> exp_month	شهر انتهاء البطاقة	String	08
> exp_year	سنة انتهاء البطاقة	String	2026
> cardholder	اسم حامل البطاقة	String	John Doe
description	وصف يمكن قراءته بواسطة الإنسان	String	Payment
txid	معرف المعاملة Idempotent (سلسلة)	String	d9428888-122b-41e1-b85c-61cb3f548aa7

ملاحظات

• يتم تطبيق منطق رسوم المجمع تلقائيًا بناءً على تكوين مفتاح API.
• تأكد من تطابق route مع مسار المعالجة الممكّن لمفتاح API المقدم.
• استخدم قيم txid غير الفعالة لتجنب عمليات الإرسال المكررة غير المقصودة.
• استرداد حالة المعاملة عبر نقطة نهاية المعاملة القياسية GET (الاقتراع حتى الوصول إلى الحالة الطرفية).