آخرین تغییرات: ۱۳۹۹/۰۸/۲۱

سرویس تسویه

لیست تسویه ها

در این بخش شما می‌توانید همه‌ی تسویه‌هایی را که تا به حال ثبت کرده‌اید، مشاهده نمایید.

نکته! پارامتر deductible_amount نشان‌دهنده مبلغ قابل برداشت امروز و پارامتر blocked_amount نشان‌دهنده مبلغ مسدود‌شده در حساب است.
نکته! انواع حالت‌های ممکن تسویه (فیلد status مربوط به settlement) عبارتند از: INIT, PENDING, DONE, FAILED, CANCELED

- INIT: وقتی که تسویه به بانک فرستاده می‌شود.
- PENDING: وقتی که تسویه به بانک فرستاده شده و در انتظار رسیدن به سیکل مورد نظر است.
- DONE: تسویه‌ای که با موفقیت انجام شده است.
- FAILED: تسویه‌ای که با خطا مواجه شده است.
- CANCELED: تسویه لغو شده است. لازم به ذکر است که امکان لغو تسویه در وضعیت تسویه‌ی آنی وجود ندارد.
METHOD: GET
URL: https://api.vandar.io/v2.1/business/{business}/settlement
                      

پارامتر {business} همان نام انگلیسی کسب و کاری است که قصد مشاهده‌ی تسویه‌های آن را دارید.

نمونه پاسخ دریافتی موفق:

HTTP/1.1 200
{
"status": 1,
"data": {
  "wallet": 26099,
  "blocked_amount": 0,
  "deductible_amount": 26099,
  "currency": "Toman",
  "settlements": {
    "data": [
      {
        "id": "8edaa0a0-a33f-11ea-838d-676dce32760e",
        "iban_id": 22822, 
        "gateway_transaction_id": 159024236678,
        "amount": 100000,
        "payment_number": null,
        "status": "CANCELED",
        "wallet": 160985,
        "settlement_date": "2020-05-31"
      },
      {
        "id": "807003f0-8398-11ea-a42b-ede62b9de0c1",
        "iban_id": 902,
        "gateway_transaction_id": 158745010355,
        "amount": 50000,
        "payment_number": null,
        "status": "DONE",
        "wallet": 99485,
        "settlement_date": "2020-04-21"
      },
      {
        "id": "010a7850-82ff-11ea-85bd-49ef214903e3",
        "iban_id": 902,
        "gateway_transaction_id": 158738422601,
        "amount": 68000000,
        "payment_number": null,
        "status": "DONE",
        "wallet": 126485,
        "settlement_date": "2020-04-21"
      },
      {
        "id": "53665740-82cf-11ea-baf3-95ebee6a9eca",
        "iban_id": 26,
        "gateway_transaction_id": 158736374134,
        "amount": 15000000,
        "payment_number": null,
        "status": "CANCELED",
        "wallet": 43126485,
        "settlement_date": "2020-04-21"
      },
      {
        "id": "456afdb0-82cf-11ea-8e13-3183b5b1630b",
        "iban_id": 7215,
        "gateway_transaction_id": 158736367341,
        "amount": 5000000,
        "payment_number": null,
        "status": "CANCELED",
        "wallet": 58126485,
        "settlement_date": "2020-04-21"
      }
    ],
    "first": "https:\/\/api.settlement.vandar.io\/v1\/settlements?page=1",
    "last": "https:\/\/api.settlement.vandar.io\/v1\/settlements?page=19",
    "prev": null,
    "next": "https:\/\/api.settlement.vandar.io\/v1\/settlements?page=2",
    "current_page": 1,
    "from": 1,
    "last_page": 19,
    "path": "https:\/\/api.settlement.vandar.io\/v1\/settlements",
    "per_page": 5,
    "to": 5,
    "total": 93
  }
}
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • data:
    • wallet: مبلغ کیف پول کاربر به تومان
    • blocked_amount: مبلغی که به دستور احکام قضایی در حساب مسدود شده است.
    • deductible_amount: مبلغ قابل برداشت امروز
    • currency:
    • settlements:
      • data:
        • id: شناسه تسویه
        • iban_id: شناسه یکتای شماره شبا که برای پیگیری شبا در وندار مورد استفاده قرار می گیرد
        • gateway_transaction_id: شناسه یکتای تسویه که برای پیگیری تسویه از وندار مورد استفاده قرار می‌گیرد.
        • amount: مبلغ تسویه به تومان
        • payment_number: شناسه واریز ثبت شده در هنگام ثبت تسویه
        • status: وضعیت تسویه
        • wallet: مبلغ کیف پول بعد از انجام این تسویه
        • settlement_date: (میلادی) تاریخ انجام تسویه
      • first: آدرس اولین صفحه
      • last: آدرس آخرین صفحه
      • prev: آدرس صفحه قبل
      • next: آدرس صفحه بعد
      • current_page: آدرس همین صفحه
      • from: شماره اولین آیتم تسویه ای که در این صفحه آمده است
      • last_page: تعداد کل صفحات تسویه
      • path: آدرس خالص بدون صفحه بندی
      • per_page: تعداد آیتم در هر صفحه
      • to: شماره آخرین آیتم تسویه ای که در این صفحه آمده است
      • total: تعداد کل آیتم های تسویه
HTTP/1.1 4xx
{
"status": 0,
"error": "Unauthenticated"
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • errors: آرایه ای از خطا‌ها

ثبت درخواست تسویه

در این بخش شما می‌توانید یک درخواست تسویه را ثبت نمایید.

METHOD: POST
URL: https://api.vandar.io/v3/business/{business}/settlement/store
                      

پارامتر {business} همان نام انگلیسی کسب و کاری است که قصد ثبت تسویه برای آن را دارید.

پارامترهای مجاز

name Type Status
amount integer required
iban string required
track_id string required
payment_number integer optional
notify_url string optional
is_instant boolean optional

توضیحات

  • amount (اجباری): مبلغ تراکنش به تومان و بزرگتر یا مساوی 5000 و کوچکتر یا مساوی مبلغ کیف پول
  • iban (اجباری): شماره شبا ای که می خواد پول به آن واریز شود
  • track_id (اجباری): رشته پیگیری که به ازای هر درخواست تسویه بایستی یکتا باشد. پیشنهاد ما استفاده از uuid برای این پارامتر است.
  • payment_number (اختیاری): شناسه واریز شماره ای اختیاری است تا حداکثر ۱۵ رقم.
  • notify_url (اختیاری): بعد از مشخص شدن وضعیت تسویه این آدرس صدا زده می‌شود.
  • is_instant (اختیاری): اگر می‌خواهید تسویه در لحظه انجام شود مقدار true و در غیر این صورت مقدار false را ارسال کنید.
نکته! دو پارامتر notify_url و is_instant با هماهنگی فعال خواهند شد.

نمونه json

{
"amount": 50000,
"iban": "IR430550011480005587452001",
"track_id": "6feb8114-25d5-372e-83e0-23ae783041a9",
"payment_number": "123456",
"notify_url": "https://yourdomain.com/nofiy_me",
"is_instant": false
}
                    

نمونه پاسخ دریافتی موفق:

HTTP/1.1 200
{
"status": 1,
"data": {
  "settlement": [
    {
      "id": "b6c72d20-a4ba-11ea-8a6c-9dc8b4b708ac",
      "iban_id": "b6b5c440-a4ba-11ea-837b-bf6e427ec6d0",
      "transaction_id": 159100434426,
      "amount": 50000,
      "payment_number": null,
      "status": "PENDING",
      "wallet": 60985,
      "settlement_date": "2020-06-02",
      "settlement_date_jalali": "1399\/03\/13"
    }
  ]
}
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • data:
    • wallet: مبلغ کیف پول کاربر به تومان
    • blocked_amount: مبلغی که به دستور احکام قضایی در حساب مسدود شده است.
    • deductible_amount: مبلغ قابل برداشت امروز
    • currency:
    • settlements:
      • data:
        • id: شناسه تسویه
        • iban_id: شناسه یکتای شماره شبا که برای پیگیری شبا در وندار مورد استفاده قرار می گیرد
        • transaction_id: شناسه یکتای تسویه که برای پیگیری تسویه از وندار مورد استفاده قرار می‌گیرد.
        • amount: مبلغ تسویه به تومان
        • payment_number: شناسه واریز ثبت شده در هنگام ثبت تسویه
        • status: وضعیت تسویه
        • wallet: مبلغ کیف پول بعد از انجام این تسویه
        • settlement_date: (میلادی) تاریخ انجام تسویه
        • settlement_date_jalali: تاریخ انجام تسویه (شمسی)

نمونه پاسخ دریافتی ناموفق:

HTTP/1.1 4xx
{
"status": 0,
"error": "Unauthenticated"
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • errors: آرایه ای از خطا‌ها

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

در این بخش شما می‌توانید یک درخواست تسویه را نمایش دهید.

METHOD: GET
URL: https://api.vandar.io/v2.1/business/{business}/settlement/{id}
                      

پارامتر {business} همان نام انگلیسی کسب و کاری است که قصد دارید یک تسویه از آن را نمایش دهید.

پارامتر {id} همان id مربوط به تسویه‌ای است که قصد نمایش آن را دارید.

نمونه پاسخ دریافتی موفق:

HTTP/1.1 200
{
  "status": 1,
  "data": {
    "settlement": {
      "id": "8edaa0a0-a33f-11ea-838d-676dce32760e",
      "iban_id": 22822,
      "gateway_transaction_id": 159024236678,
      "amount": 100000,
      "payment_number": null,
      "status": "CANCELED",
      "wallet": 160985,
      "settlement_date": "2020-05-31"
    }
  }
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • data:
    • wallet: مبلغ کیف پول کاربر به تومان
    • blocked_amount: مبلغی که به دستور احکام قضایی در حساب مسدود شده است.
    • deductible_amount: مبلغ قابل برداشت امروز
    • currency:
    • settlements:
      • data:
        • id: شناسه تسویه
        • iban_id: شناسه یکتای شماره شبا که برای پیگیری شبا در وندار مورد استفاده قرار می گیرد
        • gateway_transaction_id: شناسه یکتای تسویه که برای پیگیری تسویه از وندار مورد استفاده قرار می‌گیرد.
        • amount: مبلغ تسویه به تومان
        • payment_number: شناسه واریز ثبت شده در هنگام ثبت تسویه
        • status: وضعیت تسویه
        • wallet: مبلغ کیف پول بعد از انجام این تسویه
        • settlement_date: تاریخ انجام تسویه (میلادی)
HTTP/1.1 4xx
{
"status": 0,
"error": "Unauthenticated"
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • errors: آرایه ای از خطا‌ها

لغو یک تسویه

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

METHOD: DELETE
URL: https://api.vandar.io/v2.1/business{business}/settlement/{transaction_id}
                      

پارامتر {business} همان نام انگلیسی کسب و کاری است که قصد لغو یک تسویه برای آن را دارید.

پارامتر {transaction_id} همان transaction_id مربوط به تسویه‌ای است که قصد لغو آن را دارید.

HTTP/1.1 200
{
"status": 1,
"message": "درخواست تسویه شما از دستور پرداخت خارج شد و وجه تسویه به حساب شما برگشت داده شد"
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • message: درخواست تسویه شما از دستور پرداخت خارج شد و وجه تسویه به حساب شما برگشت داده شد
HTTP/1.1 4xx
{
"status": 0,
"error": "Unauthenticated"
}
                      
  • status: ما http response را مطابق آن‌چه که واقعاً اتفاق افتاده برای شما ارسال می‌کنیم؛ درخواست‌های موفقیت‌آمیز با ۲۰۰، خطاهای اعتبارسنجی را با ۴۲۲، خطای ۴۰۴ برای عدم یافتن منبعی خاص، خطاهای سمت سرور با ۵۰۰ و غیره. اما افزون بر این، فیلد status برای کمک به شماست که متوجه شوید آیا این api کاری که به آن محول شده را به درستی انجام داده است یا خیر. به طور خلاصه:
    1 به معنای این است که http response از خانواده‌ی ۲۰۰ است.
    0 به معنای این است که http response از خانواده‌ی ۴۰۰ یا ۵۰۰ است.
  • errors: آرایه ای از خطا‌ها

وضعیت سلامت بانک‌های سرویس تسویه

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

METHOD: GET
URL: https://health.vandar.io/settlement