مقدمه

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

خطاها

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" شماره کارت است را با شماره کارتی که پرداخت کننده از قبل نزد شما ثبت کرده است، تطابق می‌دهید. اما اگر به این صحت سنجی نیاز نداشته باشید. فراخوانی این سرویس اختیاری است.

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

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

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

آیا این بخش مفید بود؟بلی خیر
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

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

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

تسویه گروهی

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

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

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

تسویه در نوبت

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

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

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 یکی از بهترین روش‌های شارژ کیف پول کسب‌وکار ها است. کسب‌ و کارهایی که مبالغ زیادی از حساب آن‌ها برداشته می‌شود، با استفاده از این ویژگی می‌توانند مبلغی را از حساب بانک آینده خود به کیف پول خود در وندار اضافه کرده و پس از آن تعیین کنند که چه مقدار وجه از کیف پول‌شان خارج شود.

آیا این بخش مفید بود؟بلی خیر
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/subscription/banks/actives

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

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

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

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

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

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

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

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

ثبت درخواست برداشت وجه

این سرویس را می‌توانید تا سقف محدودیت مبلغ و تعداد برداشت تعیین شده برای مجوز فراخوانی نمایید.

پارامترها
authorization_idrequiredstring

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

amountrequiredstring

مبلغ برداشت وجه

withdrawal_daterequired if is_instant=0string

اجباری در حالت is_instant=0: تاریخی که در آن روز از حساب برداشت شود. روز معین شده باید بعد از روز جاری باشد.

پارامترهای بیشتر

این پارامتر مشخص می‌کند که برداشت وجه در همین لحظه انجام شود یا در آینده. مقدار این پارامتر می تواند 0 یا 1 باشد. 1 به معنای این که برداشت در لحظه انجام شود و 0 به این معنا که برداشت در آینده انجام شود. در صورت عدم ارسال، 1 در نظر گرفته می‌شود.

آدرس وبهوکی که می‌توانید ارسال کنید تا از وضعیت نهایی این برداشت وجه مطلع شوید که طول آن نباید بیشتر از ۲۰۴۸ کاراکتر باشد. در مواقع تست می‌توانید از وبسایت webhook.siteاستفاده کنید.

حداکثر تعداد دفعاتی که می‌خواهید برای این برداشت وجه تلاش شود. حداقل ۱ و حداکثر ۱۶ مرتبه می‌توان برای یک برداشت وجه تلاش کرد. دقت داشته باشید که در صورت عدم ارسال این پارامتر، مقدار آن برابر با ۱ در نظر گرفته می‌شود. همچنین در نظر داشته باشید این پارامتر برای برداشت وجه‌های آنی (is_instant: 1) برابر با ۱ در نظر گرفته می‌شود (و برداشت وجه آنی بلافاصله پس از استعلام (نمایش برداشت وجه - withdrawal show)، تعیین وضعیت می‌شود که حالت FAILED است یا DONE). در صورتی که برداشت وجه به صورت آنی نباشد (is_instant: 0) اگر برداشت وجه موفقیت‌آمیز باشد (status: DONE) که دیگر تلاشی صورت نمی‌گیرد، اما اگر برداشت وجه به هر دلیل موفقیت‌آمیز نباشد، تا زمانی که برداشت وجه موفقیت‌آمیز شود و یا مقدار retry_count به تعداد max_retry_count برسد سعی به برداشت وجه صورت می‌گیرد. لازم به ذکر است که تا زمانی که برداشت وجه موفقیت‌آمیز نباشد وضعیت آن برداشت وجه به حالت PENDING است و فقط زمانی که مقدار retry_count به max_retry_count (ارسالی از شما) برسد و هنوز برداشت وجه موفقیت‌آمیز نبوده باشد دیگر تلاشی برای برداشت وجه صورت نمی‌گیرد و وضعیت آن برداشت وجه از حالت PENDING به حالت FAILED تبدیل می‌شود.

توضیحات اختیاری برای ثبت برداشت وجه

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

پاسخ ها
statusinteger

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

messagestring

پیغام درخواست برداشت وجه با موفقیت ثبت شد.

idstring

شناسه درخواست برداشت وجه

authorization_idstring

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

retry_countinteger

تعداد دفعات تلاش برای برداشت وجه

max_retry_countinteger

حداکثر تعداد دفعات تلاش برای برداشت وجه

gateway_transaction_idstring

شناسه یکتای تراکنش برداشت وجه

amountinteger

مبلغ برداشت وجه

wage_amountinteger

کارمزد

payer_accountstring

اطلاعات حساب مشتری

payment_numberstring

شناسه بانکی برداشت وجه

track_idstring

شناسه پیگیری

statusstring

وضعیت درخواست برداشت وجه

descriptionstring

توضیحات

withdrawal_datestring

تاریخ درخواست برداشت وجه ارسالی توسط شما

آدرس وبهوکی که می‌توانید ارسال کنید تا از وضعیت نهایی این برداشت وجه مطلع شوید که طول آن نباید بیشتر از ۲۰۴۸ کاراکتر باشد. لازم به ذکر است که متد POST برای ارسال به این آدرس در نظر گرفته شده است و فیلدهای withdrawal_id, authorization_id, gateway_transaction_id, status, amount, wage_amount, payment_number, error_code و error_message برای شما ارسال می‌شود. در شرایطی که شما در حال تست هستید می‌توانید از وبسایت webhook.site استفاده کنید.

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

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا کد خطا برگردانده میشود)

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا متن خطا برگردانده میشود)

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

var request = require('request')
var options = {
  method: 'POST',
  url: '/v3/business/:business/subscription/withdrawal/store',
  headers: {
    Accept: 'application/json',
    Authorization: 'Bearer token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    authorization_id: '9f307e30-dc77-11ea-830e-7533ca1787c5',
    amount: '10000',
    withdrawal_date: '2020-07-04',
    is_instant: 1,
    notify_url: 'https://yourdomain.com/notify/me',
    max_retry_count: 1,
    description: 'تست',
    track_id: 'd2c5bf5a-280f-4ee5-8888-3d220b63bcc0'
  })
}
request(options, function (error, response) {
  if (error) throw new Error(error)
  console.log(response.body)
})


{
  "status": 1,
  "message": "درخواست برداشت وجه با موفقیت ثبت شد.",
  "result": {
    "withdrawal": {
      "id": "8c6e27c0-dbbd-11ea-a2f6-e9c8bf97463f",
      "authorization_id": "9f307e30-dc77-11ea-830e-7533ca1787c5",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": "159714176734",
      "amount": "10000",
      "wage_amount": 200,
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "d2c5bf5a-280f-4ee5-8888-3d220b63bcc0",
      "status": "INIT",
      "description": null,
      "withdrawal_date": "1399/05/21",
      "notify_url": "https://yourdomain.com/notify/me",
      "is_instant": 1,
      "error_code": null,
      "error_message": null
    }
  }
}

نمایش یک برداشت وجه

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

پاسخ ها
statusinteger

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

messagestring

پیغام برداشت وجه با موفقیت به نمایش درآمد.

idstring

شناسه درخواست برداشت وجه

authorization_idstring

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

retry_countinteger

تعداد دفعات تلاش برای برداشت وجه

max_retry_countinteger

حداکثر تعداد دفعات تلاش برای برداشت وجه

gateway_transaction_idstring

شناسه یکتای تراکنش برداشت وجه

amountinteger

مبلغ برداشت وجه

wage_amountinteger

کارمزد

payment_numberstring

شناسه بانکی برداشت وجه

payer_accountstring

اطلاعات حساب مشتری

track_idstring

شناسه پیگیری

statusstring

وضعیت درخواست برداشت وجه

descriptionstring

توضیحات

withdrawal_datestring

تاریخ درخواست برداشت وجه ارسالی توسط شما

آدرس وب‌هوک ارسالی جهت اطلاع از وضعیت تراکنش

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

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا کد خطا برگردانده میشود)

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا متن خطا برگردانده میشود)

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/subscription/withdrawal/:id',
  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)
})


{
  "status": 1,
  "message": "برداشت وجه با موفقیت به نمایش درآمد.",
  "result": {
    "withdrawal": {
      "id": "f3d084e0-b603-11ea-94ad-ebc7f5bf8e12",
      "authorization_id": "9f307e30-dc77-11ea-830e-7533ca1787c5",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 159281892196,
      "amount": 10000,
      "wage_amount": "200.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "d2c5bf5a-280f-4ee5-8888-3d220b63bcc0",
      "status": "DONE",
      "description": null,
      "withdrawal_date": "1399/04/04",
      "notify_url": "http://yourdomain.com/notify/me",
      "is_instant": 1,
      "error_code": null,
      "error_message": null
    }
  },
}
}

نمایش بر اساس شناسه پیگیری

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

پاسخ ها
statusinteger

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

messagestring

پیغام برداشت وجه با موفقیت به نمایش درآمد.

idstring

شناسه درخواست برداشت وجه

authorization_idstring

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

retry_countinteger

تعداد دفعات تلاش برای برداشت وجه

max_retry_countinteger

حداکثر تعداد دفعات تلاش برای برداشت وجه

gateway_transaction_idstring

شناسه یکتای تراکنش برداشت وجه

amountinteger

مبلغ برداشت وجه

wage_amountinteger

کارمزد

payment_numberstring

شناسه بانکی برداشت وجه

payer_accountstring

اطلاعات حساب مشتری

track_idstring

شناسه پیگیری

statusstring

وضعیت درخواست برداشت وجه

descriptionstring

توضیحات

withdrawal_datestring

تاریخ درخواست برداشت وجه ارسالی توسط شما

آدرس وب‌هوک ارسالی جهت اطلاع از وضعیت تراکنش

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

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا کد خطا برگردانده میشود)

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا متن خطا برگردانده میشود)

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/subscription/withdrawal/track-id/:track_id',
  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)
})


{
  "status": 1,
  "message": "برداشت وجه با موفقیت به نمایش درآمد.",
  "result": {
    "withdrawal": {
      "id": "f3d084e0-b603-11ea-94ad-ebc7f5bf8e12",
      "authorization_id": "9f307e30-dc77-11ea-830e-7533ca1787c5",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 159281892196,
      "amount": 10000,
      "wage_amount": "200.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "d2c5bf5a-280f-4ee5-8888-3d220b63bcc0",
      "status": "DONE",
      "description": null,
      "withdrawal_date": "1399/04/04",
      "notify_url": "http://yourdomain.com/notify/me",
      "is_instant": 1,
      "error_code": null,
      "error_message": null
    }
  },
}
}

تراکنش‌های برداشت وجه‌

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

پاسخ ها
idstring

شناسه درخواست برداشت وجه

authorization_idstring

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

retry_countinteger

تعداد دفعات تلاش برای برداشت وجه

max_retry_countinteger

حداکثر تعداد دفعات تلاش برای برداشت وجه

gateway_transaction_idstring

شناسه یکتای تراکنش برداشت وجه

amountinteger

مبلغ برداشت وجه

wage_amountinteger

کارمزد

payment_numberstring

شناسه بانکی برداشت وجه

payer_accountstring

اطلاعات حساب مشتری

track_idstring

شناسه پیگیری

statusstring

وضعیت درخواست برداشت وجه

descriptionstring

توضیحات

withdrawal_datestring

تاریخ درخواست برداشت وجه ارسالی توسط شما

آدرس وب‌هوک ارسالی جهت اطلاع از وضعیت تراکنش

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

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا کد خطا برگردانده میشود)

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا متن خطا برگردانده میشود)

firststring

آدرس اولین صفحه

laststring

آدرس آخرین صفحه

prevstring

آدرس صفحه قبل

nextstring

آدرس صفحه بعد

current_pageinteger

آدرس همین صفحه

frominteger

شماره اولین آیتم که در این صفحه آمده است

last_pageinteger

تعداد کل صفحات

linksarray

آرایه ای قابل استفاده برای نمایش pagination

pathstring

آدرس خالص بدون صفحه بندی

per_pageinteger

تعداد آیتم در هر صفحه

tointeger

شماره آخرین آیتمی که در این صفحه آمده است

totalinteger

تعداد کل آیتم ها

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/subscription/withdrawal',
  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": [
    {
      "id": "f3d084e0-b603-11ea-94ad-ebc7f5bf8e12",
      "authorization_id": "9f307e30-dc77-11ea-830e-7533ca1787c5",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 159281892196,
      "amount": 10000,
      "wage_amount": "200.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "d2c5bf5a-280f-4ee5-8888-3d220b63bcc0",
      "status": "DONE",
      "description": null,
      "withdrawal_date": "1399/04/04",
      "notify_url": "http://yourdomain.com/notify/me",
      "is_instant": 1,
      "error_code": null,
      "error_message": null
    },
    {
      "id": "88a2c1d0-ff9f-11eb-9054-d393c32ed3b6",
      "authorization_id": "fa99a8f0-fb51-11eb-8a87-41af5f44fd0d",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 162923462083,
      "amount": 11000,
      "wage_amount": "0.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "eb7dfff7-a752-402b-a46b-024545f06c76",
      "status": "FAILED",
      "description": null,
      "withdrawal_date": "1400/05/27",
      "notify_url": null,
      "is_instant": 1,
      "error_code": "01",
      "error_message": "عدم کفایت موجودی"
    },
    ...
  ],
  "links": {
    "first": "/v3/business/vandario/subscription/withdrawal?page=1",
    "last": "/v3/business/vandario/subscription/withdrawal?page=33",
    "prev": null,
    "next": "/v3/business/vandario/subscription/withdrawal?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 33,
    "links": [
      {
        "url": null,
        "label": "« قبلی",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=32",
        "label": "32",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=33",
        "label": "33",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=2",
        "label": "بعدی »",
        "active": false
      }
    ],
    "path": "/v3/business/vandario/subscription/withdrawal",
    "per_page": 20,
    "to": 20,
    "total": 656
  }
}

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

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

پاسخ ها
idstring

شناسه درخواست برداشت وجه

authorization_idstring

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

retry_countinteger

تعداد دفعات تلاش برای برداشت وجه

max_retry_countinteger

حداکثر تعداد دفعات تلاش برای برداشت وجه

gateway_transaction_idstring

شناسه یکتای تراکنش برداشت وجه

amountinteger

مبلغ برداشت وجه

wage_amountinteger

کارمزد

payment_numberstring

شناسه بانکی برداشت وجه

payer_accountstring

اطلاعات حساب مشتری

track_idstring

شناسه پیگیری

statusstring

وضعیت درخواست برداشت وجه

descriptionstring

توضیحات

withdrawal_datestring

تاریخ درخواست برداشت وجه ارسالی توسط شما

آدرس وب‌هوک ارسالی جهت اطلاع از وضعیت تراکنش

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

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا کد خطا برگردانده میشود)

در زمان ثبت برداشت null می باشد (بعد از استعلام برداشت وجه در صورت وجود خطا متن خطا برگردانده میشود)

firststring

آدرس اولین صفحه

laststring

آدرس آخرین صفحه

prevstring

آدرس صفحه قبل

nextstring

آدرس صفحه بعد

current_pageinteger

آدرس همین صفحه

frominteger

شماره اولین آیتم که در این صفحه آمده است

last_pageinteger

تعداد کل صفحات

linksarray

آرایه ای قابل استفاده برای نمایش pagination

pathstring

آدرس خالص بدون صفحه بندی

per_pageinteger

تعداد آیتم در هر صفحه

tointeger

شماره آخرین آیتمی که در این صفحه آمده است

totalinteger

تعداد کل آیتم ها

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

var request = require('request')
var options = {
  method: 'GET',
  url: '/v3/business/:business/subscription/withdrawal?q=:authorization_id',
  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": [
    {
      "id": "f3d084e0-b603-11ea-94ad-ebc7f5bf8e12",
      "authorization_id": "9f307e30-dc77-11ea-830e-7533ca1787c5",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 159281892196,
      "amount": 10000,
      "wage_amount": "200.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "d2c5bf5a-280f-4ee5-8888-3d220b63bcc0",
      "status": "DONE",
      "description": null,
      "withdrawal_date": "1399/04/04",
      "notify_url": "http://yourdomain.com/notify/me",
      "is_instant": 1,
      "error_code": null,
      "error_message": null
    },
    {
      "id": "88a2c1d0-ff9f-11eb-9054-d393c32ed3b6",
      "authorization_id": "fa99a8f0-fb51-11eb-8a87-41af5f44fd0d",
      "retry_count": 1,
      "max_retry_count": 1,
      "gateway_transaction_id": 162923462083,
      "amount": 11000,
      "wage_amount": "0.00",
      "payment_number": null,
      "payer_account": {
        "account_number": "807-021-2254034-1",
        "pan": "621986******0808"
      },
      "track_id": "eb7dfff7-a752-402b-a46b-024545f06c76",
      "status": "FAILED",
      "description": null,
      "withdrawal_date": "1400/05/27",
      "notify_url": null,
      "is_instant": 1,
      "error_code": "01",
      "error_message": "عدم کفایت موجودی"
    },
    ...
  ],
  "links": {
    "first": "/v3/business/vandario/subscription/withdrawal?page=1",
    "last": "/v3/business/vandario/subscription/withdrawal?page=33",
    "prev": null,
    "next": "/v3/business/vandario/subscription/withdrawal?page=2"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 33,
    "links": [
      {
        "url": null,
        "label": "« قبلی",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=1",
        "label": "1",
        "active": true
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=2",
        "label": "2",
        "active": false
      },
      {
        "url": null,
        "label": "...",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=32",
        "label": "32",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=33",
        "label": "33",
        "active": false
      },
      {
        "url": "/v3/business/vandario/subscription/withdrawal?page=2",
        "label": "بعدی »",
        "active": false
      }
    ],
    "path": "/v3/business/vandario/subscription/withdrawal",
    "per_page": 20,
    "to": 20,
    "total": 656
  }
}

انصراف از برداشت وجه

جهت لغو دستور برداشت وجه از این سرویس استفاده نمایید.

پاسخ ها
statusinteger

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

messagestring

پیغام برداشت وجه با موفقیت لغو گردید.

idstring

شناسه‌ی برداشت وجهی که قصد کنسل کردن آن را داشتید.

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

var request = require('request')
var options = {
  method: 'PUT',
  url: '/v3/business/:business/subscription/withdrawal/:id',
  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)
})


{
  "status": 1,
  "message": "برداشت وجه با موفقیت لغو گردید.",
  "result": {
    "withdrawal": {
      "id": "8c6e27c0-dbbd-11ea-a2f6-e9c8bf97463f"
    }
  }
}

خطاها

لیست خطاهای دریافتی هنگام برداشت وجه ناموفق

در سرویس‌های استعلام وضعیت برداشت وجه و همچنین در وب‌هوک ارسالی جهت اطلاع از وضعیت نهایی تراکنش، در صورتیکه تراکنش ناموفق باشد کد خطا در پارامتر error_code و شرح خطا در پارامتر error_message برگردانده می شود.

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

error_codeerror_message
00خطای داخلی، به ما اطلاع داده‌شده‌است و در حال رفع آن هستیم
01عدم کفایت موجودی
02اختلال در شبکه سرویس دهنده
03خطای سرور سرویس دهنده
04سقف مجاز تعداد تراکنش روزانه این مجوز پر شده است
05سقف مجاز تعداد تراکنش ماهانه این مجوز پر شده است
06خطای سرویس دهنده
07زمان تراکنش قبل از زمان مورد توافق در مجوز است
08مبلغ نامعتبر است
09‌مبلغ وارد شده بیش از حد مجاز روزانه است
10واگذار کننده به عنوان مشتری بانک موردنظر ثبت نشده است
11محدودیت سقف مجاز تراکنش در بانک
12مجوز فعالی برای کاربر با شماره موبایل متفاوت وجود دارد
13مجوز نامعتبر است
14مجوز منقضی شده است
15زمان انجام تراکنش برای این مجوز نامعتبر است
16مشکل در سپرده بانکی کاربر
17مجوز در بانک لغو شده است
18کارت مبدا غیرفعال می‌ باشد
19کارت مبدا منقضی شده است
20اطلاعات کارت نامعتبر است
21سپرده متعلق به کاربر نیست یا عدم وجود حق برداشت
22شماره سپرده نامعتبر است
23پارامترهای ورودی به درستی وارد نشده اند
28حساب مسدود است

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

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

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

مشتریان

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

آیا این بخش مفید بود؟بلی خیر
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_uuid

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

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

فیلد اختصاصی

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

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

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

کیف پول

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

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

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

تراکنش‌ها

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

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

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

شبا

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

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

کارت

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

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

احراز هویت

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

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

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

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

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

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

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

گزارشات

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

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

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

شناسه پرداخت

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

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

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

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

استعلام ها

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

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

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

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

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

آیا این بخش مفید بود؟بلی خیر
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

استعلام با OCR

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

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

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

صورت حساب

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

آیا این بخش مفید بود؟بلی خیر
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