شروع سریع

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

در پنل، یک پروژه با حالت آزمایشی (sandbox) بسازید، یک کارت به آن وصل کنید و از تب کلید API کلید بسازید. secret را در env سرور خود بگذارید:

VARIZAPP_API_KEY=sk_test_xxxxxxxxxxxxxxxxxxxxxxxx
VARIZAPP_API_BASE=https://api.variz.app/api

۲. پرداخت بسازید

curl -X POST "$VARIZAPP_API_BASE/v1/payments" \
  -H "Authorization: Bearer $VARIZAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": "1000000",
    "callbackUrl": "https://shop.example.com/varizapp/callback",
    "orderId": "ORD-1024",
    "description": "سفارش ۱۰۲۴"
  }'

پاسخ (خلاصه):

{
  "id": "01a0acf1-e835-7ed7-91e8-f25a128276f3",
  "status": "pending",
  "amountRequested": "1000000",
  "amountFinal": "1014320",
  "code": 1432,
  "checkoutUrl": "https://pay.variz.app/pay/Avz4_43Khv...",
  "expiresAt": "2026-09-17T10:15:00.000Z"
}

id را کنار سفارش ذخیره کنید و مشتری را به checkoutUrl هدایت کنید.

۳. شبیه‌سازی واریز (فقط sandbox)

curl -X POST "$VARIZAPP_API_BASE/v1/sandbox/simulate-deposit" \
  -H "Authorization: Bearer $VARIZAPP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "paymentId": "01a0acf1-e835-7ed7-91e8-f25a128276f3", "outcome": "match" }'

پرداخت confirmed می‌شود، وب‌هوک به آدرس‌های ثبت‌شده می‌رود و مشتری (اگر صفحه باز باشد) به callbackUrl برمی‌گردد.

۴. verify

curl -X POST "$VARIZAPP_API_BASE/v1/payments/01a0acf1-.../verify" \
  -H "Authorization: Bearer $VARIZAPP_API_KEY"

{
  "id": "01a0acf1-...",
  "status": "confirmed",
  "verified": true,
  "orderId": "ORD-1024",
  "amountFinal": "1014320"
}

فقط با verified: true سفارش را تحویل دهید.

۵. رفتن به live

پروژه‌ی live بسازید (یا حالت را عوض نکنید؛ sandbox و live پروژه‌های جدا هستند)، کلید sk_live_ بگیرید و در env جایگزین کنید. بدنه‌ها و پاسخ‌ها یکسان است.