مقدمه

API های وندار بر اساس استاندارد REST ایجاد شده اند.

تمامی پاسخ API های ما بصورت JSON-encoded پاسخ داده خواهند شد.

بوسیله ارسال توکن در هر درخواست، احراز هویت نیز انجام می شود. (ممکن است در برخی از سرویس ها نحوه احراز هویت متفاوت باشد)

محدودیت های درخواست به API

برای متد POST در هر ۳ ثانیه ۳۰ درخواست

و برای باقی متد ها در هر ۳ ثانیه ۱۰۰ درخواست قابل پذیرش است.

توجه داشته باشید که در حال حاضر برخی از مسیرها با base url روبرو تعیین نشده است.

آیا این بخش مفید بود؟بلی خیر
BASE URL

https://api.vandar.io

احراز هویت

برای دریافت توکن و رفرش توکن اولیه مالک یا مدیر کسب و کار می تواند وارد داشبورد وندار شود و کسب و کار خود را انتخاب کند. و از منوی تنظیمات بخش تنظیمات مدیریت حساب، توکن ها را انتخاب کنید. و با زدن دکمه افزودن توکن جدید، و وارد کردن یک نام برای توکن و وارد کردن رمز عبور حساب کاربری خود یک توکن و رفرش توکن در یافت کنید.

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

پارامترها
refreshtokenrequiredstring

مقداری که از فراخوانی متد قبل دریافت کرده‌اید

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/refreshtoken',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    refreshtoken: '{refreshtoken}'
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "token_type": "Bearer",
  "expires_in": 432000,
  "access_token": "bPJO9cJLGRqClDadEua7ztoCLC5E***********",
  "refresh_token": "def50200c4d2462d2de167da1*******"
}

postman

جهت تست و توسعه سرویس‌ها از کالکشن پستمن وندار استفاده نمایید.

کلیه سرویس‌های وندار در کالکشن ارائه شده موجود می‌باشد، برای تست API ها کافیست نام انگلیسی کسب‌وکار خود را بجای پارامتر business و اکسس توکن دریافتی از وندار را در پارامتر access_token ارسال نمائید.

نام انگلیسی کسب‌وکار در داشبورد وندار، بخش تنظیمات،اطلاعات پایه و در فیلد نام انگلیسی برند موجود می‌باشد.

آیا این بخش مفید بود؟بلی خیر

خطاها

API های وندار از قواعد HTTP response پیروی می‌کند.

بطور کلی در رنج 2xx پاسخ های موفق را دریافت می‌کنید.

رنج 4xx زمانی بوجود می‌آید که اطلاعات اشتباهی از سمت شما به API ها ارسال شده است.

خطاهایی در رنج 5xx نشان دهنده مشکلاتی از سمت API های وندار بوده که می توانید آن را با پشتیبانی مطرح کنید.

آیا این بخش مفید بود؟بلی خیر
HTTP STATUS CODE SUMMARY

200 - OKEverything worked as expected.
400 - Bad RequestThe request was unacceptable, often due to missing a required parameter.
401 - UnauthorizedNo valid API key provided.
402 - Request FailedThe parameters were valid but the request failed.
403 - ForbiddenThe API key doesn't have permissions to perform the request.

درگاه پرداخت IPG

برای فروشگاه‌های اینترنتی که خدمات یا محصولاتی را در وب‌سـایت خود ارائه می‌کنند، از درگاه پرداخت وندار استفاده کنید.

نکته

برای استفاده از درگاه پرداخت لازم است این ابزار را در داشبورد وندار فعال کرده و یک توکن دریافت کنید.

قبل از شروع پیاده سازی بهتر است یک بار فرایند پرداخت را با هم مرور کنیم
  • مرحله اول: ارسال اطلاعات تراکنش و دریافت توکن پرداخت.
  • مرحله دوم: انتقال کاربر به صفحه پرداخت با توکنی که از مرحله اول دریافت کردید.
  • مرحله سوم (اختیاری): قبل از تایید تراکنش اطلاعات تراکنش را دریافت می‌کنید.
  • مرحله چهارم: بعد از فرایند پرداخت کاربر به آدرسی بازگشتی که در مرحله اول ارسال کردید، بر‌میگردد. و شما برای نهایی شدن تراکنش حتما باید متد وریفای تراکنش رو صدا بزنید. و نتیجه نهایی تراکنش را دریافت کنید. پایان تراکنش

این چهار مرحله کلی مقدمه چهار نکته مهم است که توجه شما را به این نکات جلب می‌کنم

تعداد زیادی از کسب و کارها قبل از تایید یک تراکنش و نهایی کردن اون ممکنه به اطلاعات تراکنش نیاز داشته باشند. به عنوان مثال اگر بخواهید شماره کارت پرداخت کننده را قبل از نهایی کردن تراکنش صحت سنجی کنید مرحله سوم که دریافت اطلاعات شماره کارت است رو فراخوانی می‌کنید و پارامتر "cid" که هش "SHA256" شماره کارت است را با شماره کارتی که پرداخت کننده از قبل نزد شما ثبت کرده است، تطابق می‌دهید. اما اگر به این صحت سنجی نیاز نداشته باشید. فراخوانی این سرویس اختیاری است.

این ورژن آخرین ورژن درگاه پرداخت وندار است. ورژن های قدیمی وندار پابرجا است. اما با توجه به تغییرات انجام شده سرعت انجام تراکنش در این ورژن بالاتر است. و این ورژن قابلیت های درگاه پرداخت دومرحله ای و تک مرحله ای را همزمان داراست. به هیچ عنوان در ورودی و خروجی ها تغییر داده نشده است. پس فقط با تغییر آدرس می‌توانید به ورژن ۳ مهاجرت کنید.

در صورتیکه تمایل به استفاده از قابلیت سوئیچینگ هوشمند درگاه پرداخت دارید این موضوع را به پشتیبانی وندار اطلاع دهید تا برای شما فعال کنند.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST https://ipg.vandar.io/api/v3/send

GET https://ipg.vandar.io/v3/:token

POST https://ipg.vandar.io/api/v3/transaction

POST https://ipg.vandar.io/api/v3/verify

تسویه

با استفاده از سرویس تسویه می‌توانید مبلغ موردنظر از کیف پول کسب و کار خود به مقصد شبای دلخواه (تمامی شباهای سامانه بانکی کشور) واریز نمائید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/settlement/store

GET /v2.1/business/:business/settlement

GET /v2.1/business/:business/settlement/:settlement_id

DELETE /v2.1/business/:business/settlement/:transaction_id

GET /v3/business/:business/settlement/banks

تسویه گروهی

با استفاده از سرویس تسویه گروهی می‌توانید تسویه های خود به صورت دسته ای (گروهی) یکجا ثبت نمائید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST https://batch.vandar.io/api/v2/business/:business/batches-settlement

GET https://batch.vandar.io/api/v2/business/:business/batches

GET https://batch.vandar.io/api/v2/business/:business/batch-settlements/:batch_id

تسویه در نوبت

با استفاده از سرویس تسویه در نوبت می‌توانید هنگامی که کیف پول شما به اندازه کافی موجودی ندارد، تسویه های خود ثبت نمائید و پس از اینکه کیف پول شما افزایش پیدا کرد این تسویه‌ها به بانک ارسال می‌شود.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/settlement/queued

GET /v3/business/:business/settlement/queued

GET /v3/business/:business/settlement/queued/:id

POST /v3/business/:business/settlement/queued/cancel

ابزار واریز بانکی

ابزار «واریز بانکی» یا به اصطلاح ،cash in یکی از بهترین روش‌های شارژ کیف پول کسب‌وکار ها است. کسب‌ و کارهایی که مبالغ زیادی از حساب آن‌ها برداشته می‌شود، با استفاده از این ویژگی می‌توانند مبلغی را از حساب بانک آینده خود به کیف پول خود در وندار اضافه کرده و پس از آن تعیین کنند که چه مقدار وجه از کیف پول‌شان خارج شود.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v3/business/:business/cash-in/account

POST /v3/business/:business/cash-in/account/deposit

POST /v3/business/:business/cash-in/account/balance

واریز شناسه‌دار

«واریز شناسه‌دار»، سرویس مکمل سایر روش‌های پرداخت است که افراد و سازمان‌ها از آن استفاده می‌کنند. به کمک این سرویس، می‌توانید بدون محدودیت در شبکه بانکی، پرداخت و دریافت وجه داشته باشید. این سرویس به صورت پیشفرض برای همه کسب‌وکارهای فعال، قابل استفاده بوده و برای هر کسب‌وکار یک شناسه یکتا منحصر به فرد تخصیص می‌یابد. با استفاده از «واریز شناسه‌دار» این امکان وجود دارد که با واریز وجه از همه بانک‌هایی که در آن حساب دارید، موجودی «کیف پول وندار» خود را افزایش دهید.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v3/business/:business/cash-in/code

GET /v3/business/:business/cash-in/suspicious-payment

POST /v3/business/:business/cash-in/suspicious-payment/:id

پرداخت خودکار

سرویس پرداخت خودکار یا دایرکت دبیت سرویسی است که یک فرد وجوهی را از حساب بانکی شخص دیگری خارج می کند در واقع شما به بانک اجازه می دهید که مبلغی را مستقیما از حسابتان کسر و در قبال آن خدماتی را به شما ارایه دهد. به طور کلی دایرکت دبیت برداشت مستقیم پول برای انجام معاملات مالی در صورت صدور مجوز توسط پرداخت کننده می باشد. این کار بیشتر زمانی انجام می شود که شما بخواهید اشتراک خود را تمدید کنید.

آیا این بخش مفید بود؟بلی خیر

بانک‌ها

لیست بانک‌های فعال دایرکت‌دبیت برای کسب‌وکار شما از طریق این سرویس قابل دسترس می‌باشد. همچنین امکان مدیریت بانک‌ها در داشبورد وندار، بخش پرداخت خودکار فراهم می‌باشد.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v3/business/:business/subscription/banks/actives

مجوز پرداخت از حساب

جهت دسترسی به حساب در سرویس پرداخت خودکار، نیاز به ایجاد یک مجوز در بانک وجود دارد. بر اساس این مجوز، کسب‌وکار شما اجازه برداشت از حساب کاربر را خواهد داشت.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/subscription/authorization/store

GET https://subscription.vandar.io/authorizations/:token

PATCH /v3/business/:business/subscription/authorization/:authorization_id/verify

GET /v3/business/:business/subscription/authorization/:authorization_id/search

GET /v3/business/:business/subscription/authorization

GET /v3/business/:business/subscription/authorization/:authorization_id/calculation

DELETE /v3/business/:business/subscription/authorization/:authorization_id

پرداخت از حساب

در این سرویس می‌توانید از حساب کاربران خود یکبار یا به صورت دوره‌ای بر اساس مجوزی که از کاربر گرفته‌اید، وجهی را برداشت نمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/subscription/withdrawal/store

GET /v3/business/:business/subscription/withdrawal/:withdrawal_id

GET /v3/business/:business/subscription/withdrawal/track-id/:track_id

GET /v3/business/:business/subscription/withdrawal

GET /v3/business/:business/subscription/withdrawal?q=:authorization_id

PUT /v3/business/:business/subscription/withdrawal/:withdrawal_id

بازگشت وجه

جهت بازگشت وجه یک تراکنش موفق پرداخت از حساب، می‌توانید از این سرویس استفاده نمایید.

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

لیست بانک‌هایی که از این قابلیت پشتیبانی می‌کنند: بانک ملی، پست‌بانک‌ایران، اقتصادنوین، سامان، سرمایه، سینا، آینده، دی، ایران‌زمین، کشاورزی، فردابانک، مهرایران، پارسیان، تجارت

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/subscription/refunds

GET /v3/business/:business/subscription/refunds/:refund_id

GET /v3/business/:business/subscription/refunds

معامله امن «میاندو»

میاندو برای خریدار هویت فروشنده و برای فروشنده، پرداخت مبلغ از سوی خریدار را تضمین می‌کند. خریدار مبلغ معامله را نزد میاندو به امانت می‌گذارد تا پس از ارائه کالا یا خدمت و تایید خریدار، این مبلغ برای فروشنده آزاد شود.

آیا این بخش مفید بود؟بلی خیر

مشتریان

مشتریان در میاندو به اشخاصی اطلاق می‌شود که به عنوان طرفین معامله (خریدار، فروشنده) به خرید و فروش می‌پردازند.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /miando/api/v1/customers

GET /miando/api/v1/customers

GET /miando/api/v1/customers/:id

معاملات

پیش نویسی است که پس از تایید طرفین به یک قرارداد بین فروشنده و خریدار در میاندو ثبت می‌شود.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /miando/api/v1/agreements

POST /miando/api/v1/agreements/:tracking_code

POST /miando/api/v1/agreements/:tracking_code/finalize

POST /miando/api/v1/agreements/:tracking_code/cancel

GET /miando/api/v1/agreements

GET /miando/api/v1/agreements/:tracking_code

تیکت

اگر در روند معامله مشکلی پیش آمد می‌توانید با ثبت تیکت مشکل خود را بیان کنید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /miando/api/v1/tickets

مشتریان

در این بخش سرویس‌های ثبت مشتری، فیلدهای اختصاصی مشتری، مشاهده لیست مشتریان، ویرایش اطلاعات مشتری، حذف مشتری و مشاهده اطلاعات یک مشتری ارائه می‌شوند.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v2/business/:business/customers

POST /v2/business/:business/customers

PUT /v2/business/:business/customers/:customer

DELETE /v2/business/:business/customers/:customer

GET /v2/business/:business/customers/:customer

فیلد اختصاصی

با استفاده از این سرویس می‌توانید فیلدهای اختصاصی برای کسب و کار ثبت نمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v2/business/business/customers/fields

POST /v2/business/:business/customers/fields

PUT /v2/business/:business/customers/fields/:field_id

DELETE /v2/business/:business/customers/fields/:field_id

GET /v2/business/:business/customers/fields/:field_id

کیف پول

در این بخش مدیریت کیف پول مشتریان که شامل واریز، برداشت و مشاهده موجودی کیف پول مشتری می‌باشد، صورت می‌گیرد.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v2/business/:business/customers/:customer/wallet

POST /v2/business/:business/customers/:customer/wallet/deposit

POST /v2/business/:business/customers/:customer/wallet/withdraw

تراکنش‌ها

در این بخش اطلاعات تراکنش‌های مشتریان قابل مشاهده می‌باشد.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v2/business/:business/customers/:customer/transactions

شبا

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/:customer/ibans

GET /v3/business/:business/customers/:customer/ibans

DELETE /v3/business/:business/customers/:customer/ibans

POST /v3/business/:business/customers/:customer/ibans/:iban/inquiry

POST /v3/business/:business/customers/:customer/ibans/:iban/set-default

کارت

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/:customer/cards

GET /v3/business/:business/customers/:customer/cards

DELETE /v3/business/:business/customers/:customer/cards/:card

POST /v3/business/:business/customers/:customer/cards/:card/inquiry

POST /v3/business/:business/customers/:customer/cards/:card/set-default

POST /v3/business/:business/customers/:customer/cards/to-iban

احراز هویت

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

این سرویس جهت احراز هویت طرف‌حساب‌های پذیرندگان وندار ارائه شده است که توسط آن، پذیرندگان می‌توانند اطلاعات هویتی مخاطبان خود را مورد سنجش قرار دهند.

در حال حاضر وب سرویس احراز هویت مخاطبین به دو دسته کلی تقصیم شده است:

  • مخاطبینی که از قبل توسط پذیرنده ثبت نام شده اند.
  • مخاطبینی که ثبت نام نشده اند.

    برای احراز هویت کاربرانی که از قبل توسط پذیرنده ثبت نام شده اند احتیاجی به وارد کردن اطلاعات مخاطب نیست بلکه اطلاعات مخاطبین واکشی شده و در صورت وجود نقض یا مغایرت وب سرویس پیغام مناسب بر می گرداند.

برای احراز هویت مخاطبینی که از قبل توسط پذیرنده ثبت نام نشده اند وارد کردن اطلاعات مربوط به هر سرویس الزامی است.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/:customer/authentication/kyc

POST /v3/business/:business/customers/authentication/kyc

POST /v3/business/:business/customers/:customer/authentication/shahkar

POST /v3/business/:business/customers/authentication/shahkar

گزارشات

این سرویس جهت گزارش گیری از طرف‌حساب‌های پذیرندگان وندار ارائه شده است که توسط آن، پذیرندگان می‌توانند گزارش های مربوط به مخاطبان خود را مشاهده کنند.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v2/business/:customer/customers/:customer/logs

شناسه واریز

این سرویس جهت ایجاد شناسه واریز و انتصاب آن به طرف‌حساب‌های پذیرندگان وندار ارائه شده است که توسط آن، پذیرندگان می‌توانند به ازای هر مشتری یک شناسه واریز منحصر به فرد ایجاد کنند.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v3/business/:business/customers/:customer/cash-in-code

استعلام ها

سرویس استعلام مشتریان

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/inquiry/nid

POST /v3/business/:business/customers/inquiry/postal-code

POST /v3/business/:business/customers/national-code-iban-inquiry

POST /v3/business/:business/customers/match-mobile-card

استعلام هویت براساس کدملی

استعلام هویت کاربران براساس کدملی و تاریخ تولد انجام می شود.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

national_coderequiredstring

کدملی

birth_daterequiredinteger

تاریخ تولد که بصورت پشت سرهم باید نوشته شود

inquiry_typeoptionalboolean

ارسال مقدار نوع استعلام، اختیاری بوده و بر اساس نیاز کسب و کار، این سرویس در دو حالت normal و extreme ارائه می شود. حالت پیش فرض، حالت normal می باشد که پایداری بالا برای ارائه بیشترین اطلاعات ممکن با کمترین نرخ خطا فراهم شده است، که برای تعداد فراخوانی زیاد مناسب است. در حالت extreme کامل ترین اطلاعات ولی با پایداری کمتر و نرخ خطا بالاتر ارائه می شود که برای تعداد فراخوانی کم مناسب است

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/nid',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer token'
  },
  body: JSON.stringify({
    national_code: '0123456789',
    birth_date: 13820214,
    inquiry_type: 'normal'
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "national_code": "0111111111",
    "birth_date": "1382/02/14",
    "first_name": "علی",
    "last_name": "فراهانی",
    "father_name": "محمد",
    "aliveness": "alive",
    "gender": "male",
    "birth_place": "تهران",
    "register_no": "0",
    "register_series": "18ب",
    "register_serial": "596807",
    "images": [
      {
        "type": "Card",
        "image": "data:image"
      },
      {
        "type": "Cert",
        "image": "data:image"
      }
    ]
  }
}

استعلام آدرس براساس کدپستی

استعلام آدرس براساس کدپستی

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

postal_coderequiredstring

کدپستی ۱۰ رقمی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/postal-code',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer token'
  },
  body: JSON.stringify({
    postal_code: 1894156963
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "avenue": "بن بست هجدهم",
    "floor_no": "همکف",
    "house_no": "12.0",
    "location": "تهران",
    "location_type": "شهر",
    "parish": "شکوفه شمالی ",
    "post_code": "1894156963",
    "pre_avenue": "خیابان شهید غلامحسین زنهاری",
    "side_floor": "",
    "state": "تهران",
    "town_ship": "تهران",
    "village": "",
    "zone": "مرکزی",
    "building_name": "",
    "description": "",
    "location_code": "17373"
  }
}

استعلام و تطبیق کدملی و شبا

استعلام و تطبیق کدملی و شماره شبا بر اساس کدملی، تاریخ تولد و شماره شبا انجام می شود.
در این سرویس انطباق نام مالک شبا با نام مالک کدملی به همراه میزان این انطباق بر حسب درصد انجام می‌شود.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

national_coderequiredstring

کدملی

birth_daterequiredinteger

تاریخ تولد

ibanrequiredstring

شماره شبا

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/national-code-iban-inquiry',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer token'
  },
  body: JSON.stringify({
    national_code: '0111111111',
    birth_date: 13820214, 
    iban: 'IR111110000000000011111111'  
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "percent_compatibility": 4,
    "iban": {
      "iban": "IR111110000000000011111111",
      "account_owners": [
        {
          "lastName": "رضایی",
          "firstName": "علی"
        }
      ]
    },
    "national-code": {
      "alive": true,
      "birth_date": "1376/02/01",
      "nid": "20797680",
      "first_name": "محمد",
      "last_name": "اکبری",
      "father_name": "رضا",
      "gender": null,
      "office_code": null,
      "office_name": null,
      "shenasname_no": null,
      "shenasname_seri": null,
      "shenasname_serial": null,
      "images": null
    }
  }
}

تطبیق شماره موبایل با شماره کارت

این سرویس برای تطبیق شماره کارت با شماره موبایل استفاده می شود. در این سرویس شماره کارت 16 رقمی بانکی به همراه شماره موبایل دریافت می شود. و در خروجی اعلام میکند که ایا شماره موبایل اعلام شده با شماره موبایل ثبت شده برای کارت بانکی یکسان است یا خیر.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

mobilerequiredstring

شماره موبایل

card_numberrequiredstring

شماره کارت

پاسخ ها
resultinteger

مقدار MATCH نشان دهنده تطبیق شماره موبایل با شماره کارت می باشد. و مقدار NOT_MATCH نشان دهنده عدم تطبق شماره موبایل با شماره کارت می باشد.

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/match-mobile-card',
  headers: {
    Accept: 'application/json',
    'Content-Type': 'application/json',
    Authorization: 'Bearer token'
  },
  body: JSON.stringify({
    mobile: '09353917307',
    card_number: '6362141801078636', 
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "result": "MATCH"
  }
}

استعلام هویت با هوش مصنوعی

استعلام هویت براساس هوش مصنوعی

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/inquiry/kyc/face-recognition-by-image

POST /v3/business/:business/customers/inquiry/kyc/face-recognition-by-video

POST /v3/business/:business/customers/inquiry/kyc/face-match-with-national-card

POST /v3/business/:business/customers/inquiry/kyc/random-gesture

فرآیند با تصویر

برای احراز هویت با تصویر کارت ملی لازم است تصاویر با حداکثر 12 mb ارسال شود.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

national_coderequiredstring

کدملی

birth_daterequiredinteger

تاریخ تولد که بصورت پشت سرهم باید نوشته شود

selfie_imagerequiredfile

تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/kyc/face-recognition-by-image',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token'
  },
  formData: {
    national_code: '0023032583',
    birth_date: '13770214',
    selfie_image: {
      value: fs.createReadStream('/selfi.jpg'),
      options: {
        filename: 'selfi.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "kyc_id": "707e8dc0-0539-49d2-a16e-cd474fd8f038",
    "question": "2,3,4",
    "first_name": "علی",
    "last_name": "فراهانی",
    "father_name": "یوسف",
    "national_code": "0023032583",
    "birth_date": "13770214",
    "similarity": 0.7887144088745117,
    "verified": true
  }
}

فرآیند با ویدیو

برای استفاده از این api نیاز است ابتدا api مربوط به تصویر کارت ملی را صدا زده باشید. دقت شود فرمت فایل باید mp4 باشد و حداکثر اندازه آن 12 mb

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

kyc_idrequiredstring

شناسه یکتا بدست آمده از api تصویر کارت ملی

videorequiredfile

فیلم سلفی که در آن باید بوسیله انگشتان دست اعدادی که در api تصویر کارت ملی بدست آمده توسط فرد نشان داده شود.

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/kyc/face-recognition-by-video',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token'
  },
  formData: {
    kyc_id: '0023032583',
    video: {
      value: fs.createReadStream('/selfi.mp4'),
      options: {
        filename: 'selfi.mp4',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "kyc_id": "707e8dc0-0539-49d2-a16e-cd474fd8f038",
    "question": "2,3,4",
    "first_name": "علی",
    "last_name": "فراهانی",
    "father_name": "یوسف",
    "national_code": "0023032583",
    "birth_date": "13770214",
    "similarity": 0.7887144088745117,
    "verified": true
  }
}

تطبیق عکس کارت ملی

این api تصویر کارت ملی را با تصویر سلفی مطابقت میدهد توجه داشته باشید حداکثر اندازه فایل ها باید 12 mb باشد.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

selfie_imagerequiredfile

تصویر سلفی کاربر

national_card_imagerequiredfile

تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/kyc/face-match-with-national-card',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token'
  },
  formData: {
    selfie_image: {
      value: fs.createReadStream('/selfi.jpg'),
      options: {
        filename: 'selfi.jpg',
        contentType: null
      }
    },
    national_card_image: {
      value: fs.createReadStream('/cad-meli.jpg'),
      options: {
        filename: 'cad-meli.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "kyc_id": "ad59d5e7-e58a-4b6d-a052-40da178dc5b2",
    "question": "2,3,5",
    "first_name": "علی",
    "last_name": "فراهانی",
    "father_name": "یوسف",
    "national_code": "0182332382",
    "birth_date": "13770418",
    "similarity": 0.7887144088745117,
    "verified": true
  }
}

سوالات تصادفی

با هر درخواست به این api می توانید سوالات جدیدی ایجاد کنید.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

kyc_idrequiredstring

شناسه یکتا بدست آمده از api تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/kyc/random-gesture',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token'
  },
  formData: {
    kyc_id: '13215057-70e8-4569-b7fc-3ca810cc3562'
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "gesture": "2,3,4"
  }
}

استعلام با OCR

استعلام هویت براساس کدملی و تاریخ تولد

استفاده از سرویس‌های استعلامی نیازمند فعال‌سازی آن از سمت پشتیبانی است. برای فعال‌سازی این سرویس درخواست خود را از بخش تیکت‌ها ارسال فرمایید.

آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/customers/inquiry/ocr/national-card

POST /v3/business/:business/customers/inquiry/ocr/credit-card

POST /v3/business/:business/customers/inquiry/ocr/face-recognition

POST /v3/business/:business/customers/inquiry/ocr/civil-registration

کارت ملی

در این api با ارسال تصویر کارت ملی اطلاعات کارت ملی کاربر پاسخ داده می شود. دقت شود تصاویر باید با حداکثر 12 mb باشد

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

filerequiredfile

تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/ocr/national-card',
  headers: {
    Authorization: 'Bearer token'
  },
  formData: {
    file: {
      value: fs.createReadStream('cad-meli.jpg'),
      options: {
        filename: 'cad-meli.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "national_code": "0282232583",
    "birth_date": "1387/12/11",
    "expire_date": "1403/12/06",
    "first_name": "علی",
    "last_name": "فراهانی",
    "father_name": "یوسف"
  }
}

کارت بانکی

نمایش اطلاعات بانکی از تصویر کارت بانکی

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

filerequiredfile

تصویر کارت بانکی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/ocr/credit-card',
  headers: {
    Authorization: 'Bearer token'
  },
  formData: {
    file: {
      value: fs.createReadStream('credit-card-3.jpg'),
      options: {
        filename: 'credit-card-3.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "card_number": "6362141129089232"
  }
}

تشخیص چهره

این api می تواند چهره کاربر را شناسایی کند و میزان شباهت را در پاسخ نمایش دهد. دقت شود تصاویر با حداکثر سایز 12 mb ارسال شود.

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

selfie_imagerequiredfile

تصویر سلفی کاربر

national_card_imagerequiredfile

تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/ocr/face-recognition',
  headers: {
    Authorization: 'Bearer token'
  },
  formData: {
    selfie_image: {
      value: fs.createReadStream('selfi.jpg'),
      options: {
        filename: 'selfi.jpg',
        contentType: null
      }
    },
    national_card_image: {
      value: fs.createReadStream('cad-meli.jpg'),
      options: {
        filename: 'cad-meli.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

هویت با تصویر کارت ملی

در این api با ارسال تصویر کارت ملی اطلاعات کارت ملی کاربر پاسخ داده می شود. این اطلاعات به همراه تصویر کارت ملی برگردانده می شود. دقت شود تصاویر باید با حداکثر 12 mb باشد

پارامترها
businessrequiredstring

نام انگلیسی کسب و کار

national_cardrequiredfile

تصویر کارت ملی

آیا این بخش مفید بود؟بلی خیر

var request = require('request')
var fs = require('fs')
var options = {
  method: 'POST',
  url: '/v3/business/:business/customers/inquiry/ocr/civil-registration',
  headers: {
    Authorization: 'Bearer token'
  },
  formData: {
    national_card: {
      value: fs.createReadStream('cad-meli.jpg'),
      options: {
        filename: 'cad-meli.jpg',
        contentType: null
      }
    }
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "message": "عملیات با موفقیت انجام شد.",
  "data": {
    "birth_date": 13761118,
    "book_no": null,
    "book_row": null,
    "death_status": 0,
    "first_name": "مسعود",
    "last_name": "تاجر",
    "father_name": "امير",
    "gender": 1,
    "national_code": 11327680,
    "office_code": 318,
    "office_name": "تهران مركزي",
    "certificate_id": 0,
    "certificate_seri": "د15",
    "certificate_serial": "512658",
    "images": [
      {
        "type": "Card",
        "imahe": "/9j/4AAQSkZJRgABAQECWAJYAAD/2wBDACAWGBwYFCAcGhwkIiAmMFA0MCwsMGJGSjpQdGZ6eHJmcG6AkLicgIiuim5woNqirr7EztDOfJri8uDI8LjKzsb"
      },
      {
        "type": "Cert",
        "image": "/9j/4AAQSkZJRgABAQECWAJYAAD/2wBDACAWGBwYFCAcGhwkIiAmMFA0MCwsMGJGSjpQdGZ6eHJmcG6AkLicgIiuim5woNqirr7EztDOfJri8uDI8LjKzsb"
      }
    ]
  }
}

صورت حساب

از وب‌سرویس صورت حساب وندار جهت مشاهده موجودی کیف پول، گزارش تراکنش ها و تسویه‌ انجام شده در وندار مورد استفاده قرار می‌گیرد

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v2/business/:business/balance

GET /v3/business/:business/transaction

کسب و کار

با استفاده از این بخش می‌توانید اطلاعات کسب‌وکار و لیست کاربران کسب‌وکار خود را مشاهده کنید.

آیا این بخش مفید بود؟بلی خیر
endpoints

GET /v2/business/:business

GET /v2/business/:business/iam

بازگشت وجه

با استفاده از سرویس بازگشت وجه می توانید برای بازگرداندن مبلغ یک تراکنشِ موفقِ درگاه پرداخت، به شماره کارت پرداخت‌کننده استفاده کنید.

شرایط لازم برای بازگشت وجه
  • فعال بودن ابزار بازگشت وجه
  • موفق بودن تراکنش
  • داشتن موجودی کافی در کیف‌ پول
آیا این بخش مفید بود؟بلی خیر
endpoints

POST /v3/business/:business/transaction/:transaction_id/refund