Wallet-as-a-Service

تتيح لك واجهة برمجة تطبيقات Wallet-as-a-Service (WaaS) من Puffin إنشاء وتشغيل محافظ العملات المستقرة برمجيًا — دون إدارة مفاتيح، ودون بنية تحتية خاصة بكل شبكة، ودون بناء نظام حفظ خاص بك. إنه نفس X-API-Key الذي تستخدمه بالفعل لـ نوايا الدفع.

تنطلق WaaS في البداية مقتصرة على USDC وUSDT على Solana وPolygon وBSC وBase (Base تدعم USDC فقط — لا يوجد عقد USDT رسمي صادر عن Tether هناك). لتحصيل أي شبكة/عملة تدعمها Puffin كدفعة لمرة واحدة، استخدم نوايا الدفع بدلًا من ذلك.

ما الذي تحصل عليه

محافظ عند الطلب

ينشئ POST /v1/gateway/api/wallets محفظة لزوج شبكة + عملة ويعيد عنوانها فورًا.

الأرصدة والإيداعات

استعلم عن الرصيد الحي وسجل الإيداعات لكل محفظة — دون الحاجة إلى مستكشف بلوكتشين.

السحوبات

أرسل من أي محفظة أنشأتها إلى عنوان خارجي، بنفس آلية مفتاح عدم التكرار (idempotency) المستخدمة في نوايا الدفع.

webhooks الإيداع

يُطلق wallet.deposit.detected وwallet.deposit.confirmed لحظة وصول الأموال — راجع Webhooks.

أنشئ محفظة

curl -X POST https://api.puffinmoney.com/v1/gateway/api/wallets \
  -H "X-API-Key: mk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "chain": "BASE", "token": "USDC_BASE", "label": "EU settlement" }'

// 201
{
  "wallet": {
    "id": "8f2a1c…",
    "chain": "BASE",
    "token": "USDC_BASE",
    "address": "0x9273...6544",
    "label": "EU settlement",
    "custodyModel": "joint_custody"
  }
}

يخضع إنشاء المحافظ لحد المحافظ في خطتك، تمامًا كالمحافظ التي قد تكون أنشأتها بالفعل من لوحة التحكم.

تحقق من رصيد

curl https://api.puffinmoney.com/v1/gateway/api/wallets/8f2a1c.../balance \
  -H "X-API-Key: mk_live_..."

{ "wallet": { "id": "8f2a1c…", "chain": "BASE", "token": "USDC_BASE" }, "balance": { "available": "1250.00", "pending": "0" } }

أرسل سحبًا

curl -X POST https://api.puffinmoney.com/v1/gateway/api/wallets/8f2a1c.../withdrawals \
  -H "X-API-Key: mk_live_..." \
  -H "Idempotency-Key: wd_2026-07-22_001" \
  -d '{ "toAddress": "0xabc...", "amount": "500.00", "note": "Vendor payout" }'

يعمل رأس Idempotency-Key تمامًا كما في نوايا الدفع — إعادة استخدام نفس المفتاح تُعيد الاستجابة الأصلية بدلًا من الإرسال مرتين.

المرجع الكامل

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

البدء

طرق قبول المدفوعات

المضي قدمًا

Wallet-as-a-Service

ما الذي تحصل عليه

محافظ عند الطلب

الأرصدة والإيداعات

السحوبات

webhooks الإيداع

أنشئ محفظة

تحقق من رصيد

أرسل سحبًا

المرجع الكامل

​ما الذي تحصل عليه

محافظ عند الطلب

الأرصدة والإيداعات

السحوبات

webhooks الإيداع

​أنشئ محفظة

​تحقق من رصيد

​أرسل سحبًا

​المرجع الكامل

ما الذي تحصل عليه

أنشئ محفظة

تحقق من رصيد

أرسل سحبًا

المرجع الكامل