ابدأ مجانًا
العربية

المنصات والأسواق

امنح كل مستخدم عنوان إيداع رقميًّا خاصًّا به

العنوان الواحد للجميع هو المشكلة نفسها: يصل المال ولا شيء يخبرك لمن كان. أنشئ عميلًا بمعرّف المستخدم الخاص بك فتحصل على عنوان إيداع دائم مشتق من محفظتك — فتعرّف كل دفعة عن نفسها، ولا يمر شيء منها بنا.

ابدأ مجانًاالمطوّرون

لماذا لا يصلح عنوان واحد مشترك

كل منصة تقبل العملات الرقمية تصطدم بالجدار نفسه وبالترتيب نفسه، وغالبًا بعد أول تذكرة دعم عن دفعة لا يجدها أحد.

  • العنوان الواحد يخبرك بالمبلغ والمُرسِل، لا بأي مستخدميك يخصّ. والمطابقة بالمبلغ تنهار أول مرة يرسل فيها شخصان المبلغ نفسه.
  • الحل الالتفافي المعتاد هو تجميع كل شيء ثم الصرف لاحقًا — وهذا يحوّل ميزة دفع إلى الاحتفاظ بأموال الآخرين، وهو أثقل ما يمكن أن تحمله منصة.
  • مطالبة المستخدمين بلصق مذكّرة أو مرجع تنجح إلى أن ينسى أحدهم، فيصبح إنسان يطابق سلسلة كتل يدويًّا.

نداء واحد لكل مستخدم، مرة واحدة

ترسل معرّفك أنت للمستخدم، فتستعيد عناوين لا تتغير أبدًا — أي أن النداء يحدث عند التسجيل ولا يتكرر بعدها.

  1. 01

    أنشئ العميل بمعرّفك أنت

    مرّر معرّف المستخدم الموجود لديك في `external_ref`. لا يصكّ Unheld معرّفًا جديدًا تضطر بعده إلى تخزينه ومطابقته — فالسجل مفهرس بالمعرّف الذي تستخدمه قاعدة بياناتك أصلًا.

  2. 02

    احفظ العناوين التي تعود إليك

    تحمل الاستجابة عناوين الإيداع لذلك المستخدم، مشتقة من محفظتك أنت. وهي دائمة، فيمكنك عرضها، أو وضعها في رمز QR، أو ترك المستخدم يحفظها ويرسل من أي مكان.

  3. 03

    أضِف الرصيد إلى الحساب عند وصول إشعار الويب هوك

    تُنسب الدفعة إلى العميل صاحب ذلك العنوان، ويعيد إليك الإشعار قيمة `externalRef` الخاصة بك. وهكذا يضيف تطبيقك الرصيد إلى حساب مستخدم يعرف معرّفه مسبقًا، دون مطابقة المبالغ أو قراءة سلسلة الكتل.

النداء الحقيقي

الطلب

curl -X POST https://api.unheld.io/api/v1/customers \
  -H "Authorization: Bearer $UNHELD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "external_ref": "user_8412",
    "label": "Ada Lovelace",
    "supported_assets": ["ETH", "USDC"],
    "evm": true
  }'

الاستجابة

{
  "id": "c7f1…",
  "external_ref": "user_8412",
  "label": "Ada Lovelace",
  "evm_address": "0x…",
  "supported_assets": ["ETH", "USDC"],
  "receive_method": "auto"
}

يتطلب مفتاح API بصلاحية `customers:write`، وقراءتها تتطلب `customers:read`. وعناوين كل سلسلة يمكن للمستخدم الدفع عليها متاحة عبر `GET /api/v1/customers/:id/addresses`.

كيف تجد الدفعة صاحبها

العنوان هو المعرّف. ولأنه يخص عميلًا واحدًا بالضبط ولا يتغير، تُنسب الدفعة الواصلة دون مذكّرة ولا حقل مرجع ولا بحث بالمبلغ — وهي الأشياء الثلاثة التي تنهار في بيئة الإنتاج.

يمكن أيضًا ربط الفواتير بعميل عبر `customerId`، فتُنسب الدفعة المفردة وعنوان الإيداع الدائم إلى المستخدم نفسه، في لوحتك وفي الويب هوك على السواء.

أين يجلس المال فعلًا

تصل الأموال إلى عناوين مشتقة من محفظتك أنت. ولا يخزّن Unheld سوى الجزء العام للقراءة فقط، فلا يستطيع تحريكها ولا تجميدها ولا فقدانها، ولا يوجد هنا رصيد محتجز ليُصرف لك لاحقًا.

وما لا يخبرك به ذلك هو ما إذا كانت منصتك أنت تحتفظ بأموال لمستخدميها. والأرجح أنها كذلك، إن كانت المدفوعات تصل إلى عناوين تتحكم بها وأنت مدين بقيمتها لمستخدميك. هذا سؤال يخص ترتيبك أنت وولايتك القضائية، ولا يمكننا الإجابة عنه نيابة عنك — فاطلب استشارة. كل ما نستطيع تأكيده هو جانبنا: المال لا يمر عبر Unheld أبدًا.

البناء على هذا

كل نقطة من هذه أسهل أن تُصمَّم لها الآن من أن تُكتشف في بيئة التشغيل.

  • كل عناوين المستخدمين تُشتق من محفظة واحدة: محفظتك. هذا يترك لك عبارة استرداد واحدة تحميها لا واحدة لكل مستخدم، ويعني أيضًا أن الأموال ليست مفصولة لكل مستخدم على مستوى المفاتيح.
  • العنوان الدائم يُعاد استخدامه عن قصد، وهذا بالضبط ما يجعل النسب ممكنًا. ويعني كذلك أن سجل مدفوعات المستخدم إليك قابل للربط على السلسلة لكل من يعرف عنوانه.
  • عنوان المستخدم ثابت لكل عائلة سلاسل: العنوان نفسه على EVM يستقبل على كل شبكة EVM فعّلتها. وتفعيل سلسلة جديدة لا يستلزم إصدار عناوين من جديد.
  • حذف عميل يوقف مراقبة عنوانه؛ ولا يحرّك — ولا يستطيع أن يحرّك — ما أُرسل إليه بالفعل. والمال الذي يصل بعد الحذف يبقى مالك، لكن لا شيء سيخبرك به.

أسئلة

هل يحتفظ Unheld بأموال مستخدميّ؟

لا. تذهب المدفوعات إلى عناوين مشتقة من محفظتك أنت، ولا يخزّن Unheld سوى المفتاح العام للقراءة فقط، فلا رصيد هنا ولا شيء يُسحب. أما إن كانت منصتك نفسها تحتفظ بقيمة لمستخدميها فذلك سؤال آخر يخص ترتيبك أنت، ويستحق استشارة قانونية لا إجابة في صفحة تسويقية.

كم عدد المستخدمين الذين يمكن أن يكون لكل منهم عنوانه؟

لا يوجد حد لعدد العناوين لكل مستخدم — فهي مشتقة لا مأخوذة من مجموعة محدودة، وإنشاء العميل المليون هو العملية نفسها التي أنشأت الأول. المقاس هو حصة العملاء وعدد المعاملات في باقتك، وكلاهما معروض في صفحة الأسعار.

هل يمكن أن يتغير عنوان مستخدم؟

لا. وهذه هي الخاصية التي يقوم عليها التصميم كله: العنوان يعرّف المستخدم، فيُصدر مرة ويبقى. يمكنك عرضه أو تضمينه في رمز QR أو ترك المستخدم يحفظه في محفظته، وسيظل صحيحًا بعد عام.

ماذا لو دفع مستخدمان المبلغ نفسه في اللحظة نفسها؟

لا يحدث أي التباس، لأن المبالغ لا تُستخدم أصلًا للتعرّف على أحد. كل دفعة تصل إلى عنوان يخص عميلًا واحدًا بالضبط، ويحمل الويب هوك مرجعك أنت لذلك العميل — فتساوي المبالغ والتوقيت والمُرسِلين لا أثر له.

أنشئ عميلًا على شبكة الاختبار

نفّذ النداء بمفتاح API تجريبي، واستلم عناوين حقيقية، وأرسل دفعة اختبارية إلى أحدها لترى النسب يصل — قبل أي مال حقيقي.

ابدأ مجانًا

المطوّرون · الاشتراكات · الأسعار · غير حافظ للأموال · إجابات مباشرة.