یک درخواست برای سفارش،
یک وبهوک برای تایید.
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"}'// Node.js 18+ (built-in fetch); or: npm i @varizet/node
const res = await fetch('https://api.varizet.ir/v1/orders', {
method: 'POST',
headers: {
Authorization: `Bearer ${process.env.VARIZET_SECRET_KEY}`,
'Idempotency-Key': `order-${order.id}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
amount: 8500000, // integer rial
merchant_order_id: order.id,
return_url: 'https://ketabnama.ir/checkout/thanks',
}),
});
const payment = await res.json();
// send the customer to payment.payment_url<?php
// PHP 8.1+ with ext-curl; or: composer require varizet/varizet-php
$ch = curl_init('https://api.varizet.ir/v1/orders');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('VARIZET_SECRET_KEY'),
'Idempotency-Key: order-' . $order->id,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode([
'amount' => 8500000, // integer rial
'merchant_order_id' => (string) $order->id,
'return_url' => 'https://ketabnama.ir/checkout/thanks',
]),
]);
$payment = json_decode(curl_exec($ch), true);
// redirect the customer to $payment['payment_url']کار تکراری را به نرمافزار بسپارید
- مستندات پشت پلن پولی و داخل پنل
- هیچ محیط تستی؛ آزمایش با پول واقعی
- یک 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.
یکپارچهسازی در یک بعدازظهر
- ۱
کلید تست بگیرید
ثبتنام رایگان؛ کلید
vz_test_بلافاصله در پنل آماده است. - ۲
سفارش بسازید
POST /v1/ordersمبلغ یکتا وpayment_urlرا برمیگرداند. - ۳
وبهوک را تایید کنید
امضای
Varizet-Signatureرا بررسی و سفارش را پرداختشده کنید. - ۴
با کلید Live منتشر کنید
همان کد، فقط کلید عوض میشود.
- Sandbox با شبیهساز واریز
- رایگان
- رویداد وبهوک
- ۱۱
- هدف دسترسپذیری API
- ۹۹٫۹٪
سوالات رایج
برای استفاده از API پلن پولی لازم است؟
سقف تعداد درخواست چقدر است؟
RateLimit-Limit، RateLimit-Remaining و RateLimit-Reset در هر پاسخ میآیند.ترتیب رسیدن وبهوکها تضمین میشود؟
created_at رویداد و وضعیت فعلی سفارش با GET /v1/orders/{id} استفاده کنید و پردازش را idempotent بنویسید.کلید تست را بگیرید و اولین سفارش را بسازید.
بدون پلن پولی و بدون کارت بانکی؛ Sandbox در پلن رایگان هم کامل است.