Hammehvaranهم‌محوران · زیرساخت
شروع همکاری
DEVELOPERS

یک API برای کل رِیل مالی و سلامت

همه‌چیز در هم‌محوران API-first است: هر قابلیت پیش از UI به‌صورت endpoint منتشر می‌شود. REST تمیز، احراز با Bearer token، و وب‌هوک‌های بلادرنگ روی SignalR.

دریافت SDKوب‌هوک‌ها
hammehvaran / quickstart
# 1) درخواست با کلید API
curl https://api.hammehvaran.ir/v1/payments \
  -H "Authorization: Bearer sk_live_..." \
  -H "X-Tenant: bank-x" \
  -d '{ "amount": 250000, "currency": "IRR" }'

احراز هویت

هر درخواست به یک کلید API و شناسه‌ی tenant نیاز دارد. کلید را در هدر Authorization و tenant را در X-Tenant بفرستید. کلیدهای sk_test_ به محیط Sandbox و sk_live_ به تولید وصل می‌شوند.

آدرس پایه

همه‌ی نقاط پایانی نسخه‌بندی‌شده‌اند و زیر این آدرس قرار دارند:

https://api.hammehvaran.ir/v1/

خطاها

کدمعناتوضیح
200OKدرخواست موفق
401Unauthorizedکلید API نامعتبر یا منقضی
403Forbiddenدسترسی tenant مجاز نیست
429Rate limitedعبور از سقف نرخ درخواست
500Server errorخطای داخلی؛ با retry امن مدیریت کنید

ZarGate LIVE

تجمیع پرداخت، کیف پول و BNPL.

POST/v1/paymentsایجاد تراکنش
GET/v1/payments/{id}وضعیت تراکنش
POST/v1/refundsبازگشت وجه
GET/v1/gatewaysفهرست درگاه‌ها

NexBex LIVE

پشتیبانی Omnichannel و تیکتینگ با AI فارسی.

POST/v1/conversationsشروع گفتگو
POST/v1/messagesارسال پیام
GET/v1/ticketsفهرست تیکت‌ها
PUT/v1/tickets/{id}به‌روزرسانی تیکت

EnginePay BETA

هسته‌ی محصولات اعتباری بانک.

POST/v1/credit-productsتعریف محصول اعتباری
POST/v1/applicationsثبت درخواست
GET/v1/applications/{id}وضعیت درخواست
GET/v1/installmentsاقساط

سایر محصولات

Darmanamo، ZarID، ZarLedger و Negahban هم همین الگوی REST را دنبال می‌کنند. مرجع کامل هر کدام در صفحه‌ی محصول قابل دسترسی است.

همه‌ی محصولات ←

آماده‌ی ساختن هستید؟

کلید Sandbox بگیرید و در چند دقیقه اولین درخواست را بفرستید.

دریافت کلید APISDKها