مقدمه

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

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

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

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

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*******"
}

خطاها

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

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

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

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

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

200 - OK	Everything worked as expected.
400 - Bad Request	The request was unacceptable, often due to missing a required parameter.
401 - Unauthorized	No valid API key provided.
402 - Request Failed	The parameters were valid but the request failed.
403 - Forbidden	The API key doesn't have permissions to perform the request.

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

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

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

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

تسویه

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

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

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

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

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

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

تسویه گروهی

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

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

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

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

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

تسویه در نوبت

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

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

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

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

GET /v3/business/:business_name/settlement/queued/:settlement_queued_id

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

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

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

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

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

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

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

دریافت موجودی حساب

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

پارامترها

businessrequiredstring

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

ibanrequiredstring

شماره شبایی که قصد دریافت موجودی آن را دارید (طبیعتاً باید این شماره شبا جزو شماره شباهایی باید باشد که هنگام فعال سازی ابزار به آن دسترسی دادید و درحال حاضر فعال میباشد)

پاسخ ها

balanceinteger

میزان موجودی کل حساب شما(ریال)

available_balanceinteger

میزان موجودی قابل برداشت حساب شما(ریال)

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/cash-in/account/balance',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    iban: 'IR880620000000302956142002'
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "balance": 4525586,
  "available_balance": 3200000
}

درخواست واریز بانکی

در این بخش، می توانید درخواست خود را برای واریز بانکی و شارژ کیف پول خود در وندار ثبت کنید

پارامترها

ibanrequiredstring

شماره شبایی که قصد واریز مبلغ از آن حساب بانکی دارید (طبیعتاً باید این شماره شبا جزو شماره شباهایی باید باشد که هنگام فعال سازی ابزار به آن دسترسی دادید و درحال حاضر فعال میباشد)

amountrequirednumeric

مبلغ واریز (ریال)

track_idrequirednumeric

رشته پیگیری که به ازای هر درخواست واریز بایستی یکتا باشد. پیشنهاد ما استفاده از uuid برای این پارامتر است.این پارامتر به حروف بزرگ و کوچک حساس است.

descriptionoptionalnumeric

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

commentoptionalnumeric

توضیحات محرمانه برای ثبت واریز که فقط داخل داشبورد کاربری و فقط برای شما قابل مشاهده خواهد بود

پاسخ ها

statusinteger

مقدار 0 و 1 دارد که نشان دهنده موفقیت آمیز بودن درخواست است

messagestring

پیغام تراکنش های واریزبانکی با موفقیت ثبت شد

cash_inobject

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

gateway_transaction_idinteger

شناسه یکتای واریز وجه

amountinteger

مبلغ واریز وجه

amount_tomaninteger

مبلغ واریز وجه (تومان)

wageinteger

کارمزد

wage_tomaninteger

کارمزد (تومان)

statusstring

وضعیت واریز وجه با مقدار INIT به معنای قرارگرفتن در صف واریز میباشد

ibanstring

شماره شبا ارسال شده برای انجام واریز بانکی

receipt_urlstring

لینک رسید واریز بانکی

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

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/cash-in/account/deposit',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    iban: 'IR880620000000302956142002',
    amount: 1500000,
    track_id: '2ca25322-d10a-49fb-a000-788e1f59ff33',
    description: 'تراکنش واریز بانکی تست'
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "status": 1,
  "message": "تراکنش های واریز بانکی با موفقیت ثبت شد",
  "data": {
    "cash_in": [
      {
        "gateway_transaction_id": 161113594985,
        "amount": 1500000,
        "amount_toman": 150000,
        "wage": 0,
        "wage_toman": 0,
        "status": "INIT",
        "iban": "IR880620000000302956142002",
        "receipt_url": "https://vand.ar/qml22"
      }
    ]
  }
}

دریافت لیست حساب های فعال

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

پارامترها

businessrequiredstring

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

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/cash-in/account',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token',
    'Content-Type': 'application/json'
  }
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})

{
  "data": [
    {
      "account_number": "0302956142002",
      "account_description": "حساب فعال است",
      "id": null,
      "IBAN": "IR880620000000302956142002",
      "account_owner": [
        {
          "firstName": "امیر",
          "lastName": "ابوئی مهریزی"
        }
      ],
      "bank_name": "آینده"
    },
    {
      "account_number": "0302956142004",
      "account_description": "حساب فعال است",
      "id": null,
      "IBAN": "IR880620000000302956142004",
      "account_owner": [
        {
          "firstName": "امیر",
          "lastName": "ابوئی مهریزی"
        }
      ],
      "bank_name": "آینده"
    }
  ]
}

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

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

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

بانک‌ها

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

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

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

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

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

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

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

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

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

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

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

DELETE /v3/business/:business/subscription/authorization/:id

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

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

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

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

GET /v3/business/:business/subscription/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/:id

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

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

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

مشتریان

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

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

POST /miando/api/v1/customers

GET /miando/api/v1/customers

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

معاملات

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

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

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

تیکت

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

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

POST /miando/api/v1/tickets

مشتریان

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

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

GET /v2/business/:business/customers

POST /v2/business/:business/customers

PUT /v2/business/:business/customers/:customer_uuid

DELETE /v2/business/:business/customers/:customer_uuid

GET /v2/business/:business/customers/:customer_uuid

فیلد اختصاصی

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

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

GET /v2/business/business/customers/fields

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

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

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

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

کیف پول

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

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

GET /v2/business/:business/customers/:customer_uuid/wallet

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

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

تراکنش‌ها

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

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

POST /v2/business/:business/customers/:customer_uuid/transactions

شبا

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

POST /v3/business/:business/customers/:customer_uuid/ibans

GET /v3/business/:business/customers/:customer_uuid/ibans

DELETE /v3/business/:business/customers/:customer_uuid/ibans

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

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

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

کارت

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

POST /v3/business/:business/customers/:customer_uuid/cards

GET /v3/business/:business/customers/:customer_uuid/cards

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

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

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

احراز هویت

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

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

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

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

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

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

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

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

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

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

گزارشات

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

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

POST /v2/business/{business}/customers/{customer_uuid}/logs

شناسه پرداخت

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

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

POST /v3/business/:business/customers/:customer_uuid/cash-in-code

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

استعلام ها

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

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

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

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

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

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

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

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

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

استعلام با OCR

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

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

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

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

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

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

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

صورت حساب

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

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

GET /v2/business/:business/balance

GET /v3/business/:business/transaction

کسب و کار

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

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

GET /v2/business/:business

GET /v2/business/:business/iam

بازگشت وجه

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

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

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