الحصول على حالة المعاملة

استرجع أحدث حالة لمعاملة معينة عن طريق id الداخلي باستخدام مفتاح API الخاص بك.

طلب

GET /api/v1/transactions/{transaction_id}?env=prod
Headers:
  x-api-key: <your_api_key>

{transaction_id} هو id الداخلي للمعاملة (UUID)، والذي تم تمريره كمقطع مسار.

حقول الاستجابة

المجال	الوصف
amount	المبلغ بالوحدات الصغيرة
amount_with_fee	المبلغ شاملاً الرسوم (الوحدات الثانوية)
amount_dest	المبلغ الوجهة للتحويل (وحدات ثانوية)، إن أمكن
currency	رمز العملة (على سبيل المثال USDT)
currency_dest	العملة الوجهة للتحويل، إن أمكن
description	الوصف الأصلي المقدم
env	prod (افتراضي). الحفاظ على هذه القيمة عند فتح الطلب وتأكيده.
error_description	تفاصيل الخطأ إذا تم رفض الحالة
finished	الانتهاء من الطابع الزمني (ISO) إذا كانت المحطة الطرفية
id	معرف المعاملة الداخلية (UUID)
route	طريق المعالجة المستخدم
started	الطابع الزمني للبدء (ISO)
status	الحالة الحالية (راجع دورة حياة الحالة في الاتفاقيات الميدانية؛ على سبيل المثال، تم الإنشاء، والشحن، والتحصيل، والاسترداد، والرفض، والفشل)
txid	المعرف الخارجي المقدم من العميل
type	نوع المعاملة (دفع أو دفع تعويضات)
widget_url	رابط القطعة (إذا كان تدفق القطعة)
simple_auth_redirect_url	3DS / مصادقة إضافية URL عند الاقتضاء

مثال

curl --location 'https://app.heth.me/api/v1/transactions/c033ceaa-3726-4479-8be3-c9af8a0b2336?env=prod' \
  --header "x-api-key: $HETH_API_KEY"

ملاحظات الاستخدام

• استطلاع مع التراجع الأسي (على سبيل المثال 1s، 2s، 4s، 8s) حتى الحالة النهائية.
• تحديد النتيجة من status؛ finished المفقود أو الموجود وحده ليس دليلاً على النتيجة.
• يجب أن يكون txid عاجزًا لكل عملية تجارية.

الاسترجاع عن طريق معرف التشغيل الخارجي

curl --get 'https://app.heth.me/api/v1/transactions/example-order-001' \
  --header "x-api-key: $HETH_API_KEY" \
  --data-urlencode 'by=txid' \
  --data-urlencode 'env=prod'