پرش به محتوای اصلی
واریزت
برای توسعه‌دهندگان

یک درخواست برای سفارش،
یک وب‌هوک برای تایید.

API واریزت به سبک APIهای پرداخت جهانی طراحی شده است: منابع روشن، شناسه‌های پیشونددار، صفحه‌بندی cursor، Idempotency برای هر POST و وب‌هوک‌های امضاشده و زمان‌دار. مستندات عمومی است و Sandbox در پلن رایگان هم باز است.

  • مستندات بدون ثبت‌نام
  • Sandbox با شبیه‌ساز واریز
  • OpenAPI 3.1
curl https://api.varizet.ir/v1/orders \
  -H "Authorization: Bearer vz_test_4eC39HqLyjWDarjt" \
  -H "Idempotency-Key: 5c1f0d7e-order-12345" \
  -H "Content-Type: application/json" \
  -d '{"amount": 8500000, "merchant_order_id": "INV-12345"}'
قبل و بعد از واریزت

کار تکراری را به نرم‌افزار بسپارید

بدون واریزت
  • مستندات پشت پلن پولی و داخل پنل
  • هیچ محیط تستی؛ آزمایش با پول واقعی
  • یک callback ساده بدون امضا و بدون تلاش مجدد
  • ارسال دوباره درخواست، سفارش تکراری می‌سازد
با واریزت
  • مستندات عمومی، مرجع OpenAPI و نمونه پروژه‌های آماده
  • کلیدهای vz_test_ و شبیه‌ساز واریز که از همان موتور تطبیق عبور می‌کند
  • ۱۱ رویداد وب‌هوک، امضای HMAC زمان‌دار و ۸ تلاش در ۲۴ ساعت
  • هدر Idempotency-Key برای همه POSTها
امکانات

ابزارهایی که انتظارش را دارید

  • Sandbox کامل

    سفارش، لینک و وب‌هوک واقعی با واریز شبیه‌سازی‌شده؛ سه کارت مجازی آماده در هر حساب تست.

  • کلید با scope و IP مجاز

    هر کلید فقط دسترسی‌های لازم را دارد (orders:write، refunds:write و…) و می‌تواند به IPهای مشخص محدود شود.

  • وب‌هوک قابل اعتماد

    چند endpoint، لاگ کامل هر تحویل، ارسال مجدد از پنل یا API و چرخش secret بدون قطعی.

  • CLI برای توسعه محلی

    با varizet listen وب‌هوک‌ها را به لوکال‌هاست بیاورید و با varizet trigger رویداد بسازید.

  • SDK رسمی

    Node.js با تایپ کامل از OpenAPI؛ PHP، لاراول و Python با کمک‌کننده تایید امضا.

  • نسخه‌بندی پایدار

    تغییر ناسازگار فقط در نسخه جدید مسیر؛ تغییرات جزئی با هدر Varizet-Version.

چطور کار می‌کند

یکپارچه‌سازی در یک بعدازظهر

  1. ۱

    کلید تست بگیرید

    ثبت‌نام رایگان؛ کلید vz_test_ بلافاصله در پنل آماده است.

  2. ۲

    سفارش بسازید

    POST /v1/orders مبلغ یکتا و payment_url را برمی‌گرداند.

  3. ۳

    وب‌هوک را تایید کنید

    امضای Varizet-Signature را بررسی و سفارش را پرداخت‌شده کنید.

  4. ۴

    با کلید Live منتشر کنید

    همان کد، فقط کلید عوض می‌شود.

Sandbox با شبیه‌ساز واریز
رایگان
رویداد وب‌هوک
۱۱
هدف دسترس‌پذیری API
۹۹٫۹٪

سوالات رایج

برای استفاده از API پلن پولی لازم است؟
برای توسعه و تست خیر؛ API در همه پلن‌ها در حالت تست باز است. برای پذیرش پرداخت واقعی با کلید Live، پلن رشد یا بالاتر لازم است.
سقف تعداد درخواست چقدر است؟
بر اساس پلن: رایگان ۶۰، رشد ۳۰۰ و حرفه‌ای ۱٬۲۰۰ درخواست در دقیقه؛ سازمانی سفارشی. هدرهای RateLimit-Limit، RateLimit-Remaining و RateLimit-Reset در هر پاسخ می‌آیند.
ترتیب رسیدن وب‌هوک‌ها تضمین می‌شود؟
خیر؛ مانند بیشتر سیستم‌های رویدادمحور ترتیب تضمین نمی‌شود. از created_at رویداد و وضعیت فعلی سفارش با GET /v1/orders/{id} استفاده کنید و پردازش را idempotent بنویسید.

کلید تست را بگیرید و اولین سفارش را بسازید.

بدون پلن پولی و بدون کارت بانکی؛ Sandbox در پلن رایگان هم کامل است.