مستندات

مستندات وب سرویس های درگاه پرداخت جیب

نسخه ۲ از وب‌ سرویس‌های جیب که در این صفحه مورد بررسی قرار گرفته است، منسوخ شده است و در تاریخ جمعه ۱۲ دی ۱۳۹۹ معادل ۱ ژانویه ۲۰۲۱ کامل حذف خواهد شد. لطفا به مستندات نسخه ۳ مراجعه کنید.

آشنایی با درگاه

درگاه پرداخت جیب -Jeeb Payment Gateway- یک سرویس اینترنتی است که هدف آن پردازش تراکنش های بلاکچین و ایجاد یک درگاه پرداخت بر روی آن است. اشخاص می توانند با استفاده از درگاه پرداخت جیب، در کنار دیگر ارزهای رایج کشور، ارزهای دیجیتال (از جمله بیت کوین) را نیز در فروشگاه ها و یا سرویس های آنلاین خود بپذیرند. بدین وسیله شما می توانید با تمامی نقاط جهان - بدون نگرانی از مشکلاتی مانند مسدود شدن حساب و ... - تجارت کنید و در لحظه تسویه حساب نمایید.

برخی از مزایای استفاده از درگاه پرداخت جیب و وب سرویس های آن:

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

قبل از شروع به موارد زیر توجه نمایید:

  • آدرس پایه کلیه ی وب سرویس ها https://core.jeeb.io می باشد.
  • کلیه ی وب سرویس ها مبتنی بر JSON می باشند. پس هنگام فراخوانی وب سرویس ها و ارسال اطلاعات به این موضوع توجه نمایید.
  • توسعه دهندگان می توانند از تست نت ها برای تست ارتباطات و منطق درگاه پرداخت خود استفاده نمایند.
  • منطقه زمانی (Time Zone) کلیه واحد های زمانی متناسب با تظیمات پذیرنده در پنل کاربری می باشد. منطقه زمانی پیشفرض UTC است.
  • در حال حاضر تمامی اعلان ها توسط وب هوک ها پردازش می شوند از این جهت پیشنهاد می شود که وب سایت خود را مجهز به SSL نمایید. پس از اضافه شدن روشی دیگر جهت ارسال و دریافت اعلان ها، استفاده از وب هوک ها فقط منوط به وجود SSL در پذیرنده خواهد بود.
  • Signature یا امضای پذیرنده محرمانه می باشد. به هیچ عنوان در اختیار کاربران وب سایت خود قرار ندهید.
  • تمامی پرداخت ها به دلیل نوسانات ارزش ارز های دیجیتال، دارای تاریخ انقضا می باشند. به این معنا که کاربر می بایست در مدت معینی اقدام به انجام تراکنش نماید، مقدار پیشفرض این مدت زمان در حال حاضر 15 دقیقه است که شما می توانید از طریق وب سرویس issue، آن را تا 2 روز تغییر دهید. در صورتی که این زمان به پایان برسد، پرداخت به صورت خودکار باطل خواهد شد و اگر تراکنشی بعد از این مدت زمان در شبکه دیده شود، به صورت واریز عادی پردازش می شود.
  • آدرس های ارائه شده در وب سرویس issue الزاما منحصر به فرد نیستند. آدرس های ارائه شده در پرداخت ها یا جدید ایجاد شده اند یا از آدرس های قدیمی (که حداقل 7 روز از تاریخ ایجاد آنها می گذرد) مجدد استفاده شده است. سپس این آدرس ها موقتا برای پرداخت جاری رزرو می شوند. اگر پرداخت منقضی یا تکمیل شود، آدرس ها از رزرو خارج می شوند و ممکن است در آینده مجدد استفاده شوند. در کل، هر چقدر مقدار پرداخت در روز شما بر روی درگاهی بیشتر باشد، احتمال دریافت آدرس تکراری کمتر است.
  • خروجی تمام وب سرویس های بخش پرداخت، شامل یک مدل مشخص و ثابت می باشد، که مقدار خروجی در فیلد result قرار می گیرد:
نام فیلد نوع فیلد اجباری شرح
hasError boolean * در صورتی که true باشد خطایی رخ داده است
errorMessage string پیام مربوط به خطای رخ داده
errorCode number شماره شناسه خطا
result object/value در صورتی که خطایی رخ داده باشد این فیلد null است

با توجه به جدول فوق، مقادیر ممکن برای errorCode و توضیحات مربوط به آن در جدول زیر شرح داده شده است:

مقدار errorCode شرح خطا
0 خطای داخلی رخ داده است
1 امضای پذیرنده اشتباه یا پذیرنده تایید نشده است
2 مقادیر ارسالی اشتباه است
3 کد رهگیری وارد شده اشتباه است
4 پرداخت در وضعیت نهایی نمی باشد
5 پرداخت قبلا از سمت پذیرنده تایید شده است
6 token پرداخت اشتباه است
7 پرداخت منقضی یا باطل شده است
8 پرداخت بسته شده است
  • ساختار داخلی جیب از ورژن 2 به بعد مالتی کوین شده است و به مرور کوین های زیر به سیستم اضافه می شوند. وضعیت کوین ها و کد آنها در زیر شرح داده شده است. توجه داشته باشید که تنها از کوین کد های زیر جهت ایجاد یک پرداخت استفاده کنید:
کد عنوان وضعیت
btc بیت کوین فعال
tbtc بیت کوین تست نت فعال
doge دوج کوین فعال
tdoge دوج کوین تست نت فعال
ltc لایت کوین فعال
tltc لایت کوین تست نت فعال
eth اتریوم به زودی

برای استفاده از تست نت ها می توانید از لینک های زیر استفاده نمایید:

عنوان لینک
بیت کوین تست نت https://coinfaucet.eu/en/btc-testnet
لایت کوین تست نت http://testnet.litecointools.com

پرداخت زمانی مالتی کوین می شود که هنگام ایجاد پرداخت، کوین های قابل پرداخت در فیلد coins درج شده باشد. برای مثال اگر مقدار btc/ltc/doge را در فیلد مذکور در وب سرویس ایجاد پرداخت وارد کنید، 3 آدرس بر روی 3 کوین مختلف ایجاد می شود. مبلغ هر کدام از این کوین ها نیز با توجه به فیلد value که واحد آن بیت کوین می باشد تنظیم می شود. حال پرداخت کننده می تواند بین 3 کوین مختلف انتخاب کند و پرداخت را فقط با استفاده از یک کوین تکمیل کند.

  • پرداخت در جیب می تواند چندین وضعیت داشته باشد که کد و معنای آن در جدول زیر شرح داده شده است:
کد وضعیت پرداخت شرح
01 وضعیت اولیه
02 در انتظار تراکنش
03 در انتظار دریافت تاییده از شبکه
04 تراکنش در جیب نهایی شده است
05 پرداخت منقضی و یا توسط کاربر باطل شده است
06 مبلغ پرداخت شده از مبلغ درخواستی کمتر است (استرداد پرداخت)
07 مبلغ پرداخت شده از مبلغ درخواستی بیشتر است (استرداد پرداخت)

این وضعیت ها در فیلد stateId، در دیتا مدل های وب سرویس های بخش پرداخت در دسترس قرار می گیرند.

روش های پیاده سازی

برای کار با درگاه پرداخت جیب شما دو انتخاب کلی دارید:

1- کنترل پروسه پرداخت توسط جیب و انتقال کاربر به صفحه پرداخت جیب

2- کنترل پروسه پرداخت توسط جیب و عدم انتقال کاربر به صفحه پرداخت جیب

روش اول پیاده سازی:

این روش تقریبا مشابه روش پیاده سازی خیلی از درگاه های بانکی مرسوم در ایران می باشد. به این شکل که شما ابتدا یک token ایجاد کرده و کاربر را با token ایجاد شده به درگاه انتقال داده و پس از تغییر وضعیت پرداخت، درگاه کاربر را مجدد به وب سایت شما انتقال می دهد.

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

مزایا و معایب:

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

مراحل اجرایی:

  • پذیرنده با استفاده از وب سرویس issue یک پرداخت ایجاد می کند (در این روش ارسال callbackUrl و webhookUrl اجباریست)
  • پذیرنده با استفاده از token ایجاد شده برای پرداخت، کاربر را به محیط درگاه منتقل می کند.
  • در صورتی که تراکنش در مدت زمان تعیین شده انجام شود، جیب کاربر را با stateId برابر با 3 از طریق callbackUrl به وب سایت پذیرنده انتقال می دهد در غیر این صورت مقدار stateId برابر با 5 که به معنی انقضای تراکنش می باشد، به اطلاع پذیرنده می رسد.
  • در صورتی که پذیرنده بر روی callbackUrl مقدار stateId برابر با 3 دریافت کرد، پرداخت موفق بوده و می بایست پیغام متناسب به کاربر نشان داده شود. منتها دقت کنید که کار به اینجا ختم نمی شود و پذیرنده می بایست منتظر اعلان جدید با وضعیت 4 باشد که از طریق webhookUrl ارسال می شود.
  • پس از دریافت تاییدیه تراکنش، در صورتی که شرایط استرداد تراکنش وجود نداشت، جیب اعلانی شامل stateId برابر با 4 برای پذیرنده ارسال می کند. پذیرنده پس از دریافت این اعلان، می بایست وضعیت سفارش را مجدد بررسی کند و اگر تمام شرایط مناسب بود، توسط وب سرویس confirm پرداخت را تایید نهایی کند. (دقت کنید که هر پرداخت تنها یکبار می تواند از سمت پذیرنده تایید شود. پس به منظور جلوگیری از double payment، تنها در صورتی که در خروجی این وب سرویس خطایی اعلام نشده بود، سفارش خود را نهایی سازی کنید)
  • پس از دریافت تاییدیه تراکنش، در صورتی که مبلغ درخواستی در پرداخت با مبلغ پرداختی در تراکنش کاربر یکسان نبود و پذیرنده اجازه استرداد تراکنش در این شرایط را داده باشد، جیب بلافاصله تراکنش را متسرد کرده و اعلانی شامل stateId برابر با 6 یا stateId برابر با 7 به پذیرنده ارسال می کند.

روش دوم پیاده سازی:

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

مزایا و معایب:

  • دیگر نیاز نیست کاربر را به درگاه انتقال دهید
  • شما می توانید با این روش در هر پلتفرمی، با UI متناسب با ساختار نرم افزار خود، بخش تراکنش را پیاده سازی نمایید
  • افراد سود جو دیگر نمی توانند ارتباطی بین پذیرنده و جیب ببینند
  • افزایش زمان پیاده سازی و تست درگاه

مراحل اجرایی:

  • پذیرنده با استفاده از وب سرویس issue یک پرداخت تولید می کند (در این روش تنها ارسال webhookUrl اجباریست)
  • مقادیر خروجی در فیلد addresses را به کاربر نشان داده می شود. کاربر می تواند به دلخواه بر روی هر کدام از آدرس های ارائه شده تراکنش ارسال کند. کاربر تنها در مدت زمان معینی می تواند تراکنش خود را ارسال کند. در صورتی که این مدت زمان به اتمام برسد، پرداخت منقضی می شود و هر گونه تراکنش به آدرس ها ارائه شده به صورت واریز عادی پردازش می شود.
  • در این مرحله پذیرنده می بایست منتظر اعلان های دریافتی بر روی webhookUrl باشد. این اعلان ها شامل stateId می باشد که مشخص می کند که پرداخت چه وضعیتی دارد.
  • پس از دریافت تاییدیه تراکنش، در صورتی که شرایط استرداد تراکنش وجود نداشت، جیب اعلانی شامل stateId برابر با 4 برای پذیرنده ارسال می کند. پذیرنده پس از دریافت این اعلان، می بایست وضعیت سفارش را مجدد بررسی کند و اگر تمام شرایط مناسب بود، توسط وب سرویس confirm پرداخت را تایید نهایی کند. (دقت کنید که هر پرداخت تنها یکبار می تواند از سمت پذیرنده تایید شود. پس به منظور جلوگیری از double payment، تنها در صورتی که در خروجی این وب سرویس خطایی اعلام نشده بود، سفارش خود را نهایی سازی کنید)
  • پس از دریافت تاییدیه تراکنش، در صورتی که مبلغ درخواستی در پرداخت با مبلغ پرداختی در تراکنش کاربر یکسان نبود و پذیرنده اجازه استرداد تراکنش در این شرایط را داده باشد، جیب بلافاصله تراکنش را متسرد کرده و اعلانی شامل stateId برابر با 6 یا stateId برابر با 7 به پذیرنده ارسال می کند.

انتقال کاربر به درگاه

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

انتقال با روش Redirect:

در این روش، جهت انتقال به درگاه پرداخت، می بایست کاربر را به همراه token - مطابق مشخصات زیر - به جیب redirect نمایید.

مشخصات:

- آدرس: api/payments/invoice?:token

- نوع درخواست: GET

انتقال با روش ارسال Form:

در این روش، جهت انتقال به درگاه پرداخت، می بایست کاربر را به همراه token - مطابق مشخصات زیر - به جیب POST نمایید.

مشخصات:

- آدرس: api/payments/invoice

- نوع درخواست: POST

- نوع دیتا: FORM

دیتا مدل ورودی:
نام فیلد نوع فیلد اجباری شرح
token string * token ایجاد شده برای پرداخت

وب سرویس ها

ایجاد پرداخت - issue:

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

آدرس های ارائه شده در این وب سرویس الزاما منحصر به فرد نیستند. آدرس های ارائه شده در پرداخت ها یا جدید ایجاد شده اند یا از آدرس های قدیمی (که حداقل 7 روز از تاریخ ایجاد آنها می گذرد) مجدد استفاده شده است.

مشخصات:

- آدرس: api/payments/:signature/issue

- نوع درخواست: POST

دیتا مدل ورودی:
ردیف نام فیلد نوع فیلد اجباری شرح
1 orderNo string * شماره سفارش در سیستم پذیرنده
2 value number * مبلغ تراکنش به بیت کوین. مبلغ پایه تمام تراکنش ها به بیت کوین محاسبه می شود و می تواند شامل 8 رقم اعشار باشد.
3 coins string * لیست کوین های قابل پرداخت. شما می توانید هر تعداد کوینی که می خواهید در این فیلد وارد کنید، ولی در حال حاضر تنها 3 کوین اول پردازش می شوند. برای مشاهده لیست کوین ها به جدول کوین ها مراجعه کنید. این فیلد می بایست به صورت زیر وارد شود.
coin1/coin2/coin3/.....
4 callbackUrl string آدرس بازگشت به وب سایت پذیرنده (اجباریست در صورتی که از روش اول پیاده سازی استفاده می کنید)
5 webhookUrl string * آدرس ارسال اعلان ها به وب سایت پذیرنده
6 language string جهت انتخاب زبان بخش پرداخت استفاده می شود، که در حال حاضر فقط en ، fa و null قابل قبول است. در صورتی که مقداری وارد نشود، بر اساس موقعیت حدودی پرداخت کننده، جیب تصمیم می گیرد که بخش پرداخت با چه زبانی بارگزاری شود.
7 expiration number مقدار اولیه 15 (دقیقه)
جهت افزایش زمان انقضای پرداخت استفاده می شود. این فیلد می تواند مقداری بین 15 تا 2880 داشته باشد.
8 allowReject boolean مقدار اولیه true
اگر true باشد و کاربر دقیقا مبلغ درخواست شده را واریز نکرده باشد، تراکنش پس از دریافت تاییدیه، از وضعیت 3 به 6 و یا 7 ختم شده و مبلغ واریز شده با کسر فی شبکه مسترد می شود.
9 allowTestNet boolean مقدار اولیه false
تنها در صورتی که این فیلد true باشد، امکان پردازش تست کوین ها در فیلد coins خواهد بود. توجه داشته باشید که تست کوین ها تنها برای برنامه نویس ها و به جهت تست ارتباطات ارائه شده اند و به هیچ عنوان نباید در نسخه نهایی استفاده شوند.
دیتا مدل خروجی (فیلد result):
ردیف نام فیلد نوع فیلد اجباری شرح
1 referenceNo string * شماره رهگیری پرداخت در جیب
2 addresses array * آرایه ای از Object هایی که شامل آدرس و مبلغ درخواستی می باشد
3 expirationTime date * تاریخ و زمان انقضای پرداخت
4 token string * token پرداخت

تایید تراکنش - confirm:

پس از اینکه اعلانی با stateId برابر با 4، مبنی بر نهایی شدن پرداخت دریافت شد، پذیرنده مجاز است که تنها یک بار پرداخت را تایید نماید.

مشخصات:

- آدرس: api/payments/:signature/confirm

- نوع درخواست: POST

دیتا مدل ورودی:
ردیف نام فیلد نوع فیلد اجباری شرح
1 token string * token پرداخت
دیتا مدل خروجی (فیلد result):
ردیف نام فیلد نوع فیلد اجباری شرح
1 isConfirmed boolean * این فیلد در خروجی حتما باید true باشد در غیر این صورت پذیرنده نباید سفارش را نهایی کند.
2 referenceNo string * شماره رهگیری پرداخت در جیب
3 orderNo string * شماره سفارش در سیستم پذیرنده
4 stateId number * کد وضعیت پرداخت
5 baseValue number * مبلغ پایه به بیت کوین، این فیلد برابر است با فیلد value در ورودی وب سرویس issue
6 coin string کوینی که کاربر بر روی آن تراکنش انجام داده است
7 value number مبلغ درخواستی بر روی کوین انتخابی
8 paidValue number مبلغ پرداختی بر روی کوین انتخابی
9 rate number نرخ تبدیل مبلغ پایه به مبلغ درخواستی کوین انتخابی
10 expirationTime date * تاریخ و زمان انقضای پرداخت
11 finalizedTime date تاریخ و زمان نهایی شدن پرداخت

وضعیت پرداخت - status:

این وب سرویس امکان این را به شما می دهد که هر زمانی که نیاز بود، وضعیت پرداخت های خود را بررسی کنید.

مشخصات:

- آدرس: api/payments/:signature/status

- نوع درخواست: POST

دیتا مدل ورودی:
ردیف نام فیلد نوع فیلد اجباری شرح
1 token string * token پرداخت
دیتا مدل خروجی (فیلد result):
ردیف نام فیلد نوع فیلد اجباری شرح
1 isConfirmed boolean * نمایانگر این است که آیا پرداخت توسط پذیرنده تایید شده است یا خیر
2 referenceNo string * شماره رهگیری پرداخت در جیب
3 orderNo string * شماره سفارش در سیستم پذیرنده
4 stateId number * کد وضعیت پرداخت
5 baseValue number * مبلغ پایه به بیت کوین، این فیلد برابر است با فیلد value در ورودی وب سرویس issue
6 coin string کوینی که کاربر بر روی آن تراکنش انجام داده است
7 value number مبلغ درخواستی بر روی کوین انتخابی
8 paidValue number مبلغ پرداختی بر روی کوین انتخابی
9 rate number نرخ تبدیل مبلغ پایه به مبلغ درخواستی کوین انتخابی
10 expirationTime date * تاریخ و زمان انقضای پرداخت
11 finalizedTime date تاریخ و زمان نهایی شدن پرداخت

اعلان و بازگشت

بازگشت به پذیرنده - callback:

callback در روش پیاده سازی اول، هنگام بازگشت کاربر به وب سایت پذیرنده مورد استفاده قرار میگیرد.

مشخصات:

- آدرس: توسط پذیرنده در وب سرویس issue تنظیم می شود

- نوع درخواست: POST

- نوع دیتا: FORM

دیتا مدل ارسالی در بازگشت:
ردیف نام فیلد نوع فیلد اجباری شرح
1 referenceNo string * شماره رهگیری پرداخت در جیب
2 orderNo string * شماره سفارش در سیستم پذیرنده
3 stateId number * کد وضعیت پرداخت
4 baseValue number * مبلغ پایه به بیت کوین، این فیلد برابر است با فیلد value در ورودی وب سرویس issue
5 coin string کوینی که کاربر بر روی آن تراکنش انجام داده است
6 value number مبلغ درخواستی بر روی کوین انتخابی
7 paidValue number مبلغ پرداختی بر روی کوین انتخابی
8 rate number نرخ تبدیل مبلغ پایه به مبلغ درخواستی کوین انتخابی

اعلان - webhook:

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

توجه داشته باشید که سرور جیب هنگام ارسال اعلان، در خروجی انتظار وضعیت OK-200 را دارد. در صورتی که کد وضعیت مقدار دیگری داشته باشد، حداکثر تا 20 بار، درخواست با فواصل زمانی افزاینده ارسال می شود.

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

  • حتما بررسی کنید که درخواست ارسالی از domain یا sub-domain جیب (https://*.jeeb.io) ارسال شده است.
  • در حال حاضر اعلان ها فقط از IP های زیر ارسال می شوند. حتما بررسی کنید که IP ارسال کننده اعلان، با یکی از IP های ارائه شده برابر باشد.
    - 35.209.237.202
    - 52.56.239.177
  • دیتا مدل ارسالی شامل امضای درگاه نیز می شود، حتما بررسی کنید که امضای ارسال شده با امضای درگاه برابر باشد.
  • پیشنهاد می شود webhook url ها برای هر پرداخت، متفاوت باشد. برای مثال از query param های خاص منظوره برای هر پرداخت استفاده کنید.
مشخصات:

- آدرس: توسط پذیرنده در وب سرویس issue تنظیم می شود

- نوع درخواست: POST

- نوع دیتا: JSON

دیتا مدل ارسالی در اعلان:
ردیف نام فیلد نوع فیلد اجباری شرح
2 attempts number * تعداد دفعات ارسال اعلان
2 referenceNo string * شماره رهگیری پرداخت در جیب
3 orderNo string * شماره سفارش در سیستم پذیرنده
4 stateId number * کد وضعیت پرداخت
5 baseValue number * مبلغ پایه به بیت کوین، این فیلد برابر است با فیلد value در ورودی وب سرویس issue
6 coin string کوینی که کاربر بر روی آن تراکنش انجام داده است
7 value number مبلغ درخواستی بر روی کوین انتخابی
8 paidValue number مبلغ پرداختی بر روی کوین انتخابی
9 rate number نرخ تبدیل مبلغ پایه به مبلغ درخواستی کوین انتخابی
10 expirationTime date * تاریخ و زمان انقضای پرداخت
11 finalizedTime date تاریخ و زمان نهایی شدن پرداخت
11 token string * token پرداخت
12 signature string * امضای دیجیتال درگاه
13 webhookUrl string * webhook url تنظیم شده برای پرداخت
14 callbackUrl string callback url تنظیم شده برای پرداخت

واحد های مالی

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

ردیف کد عنوان نوع ارز وضعیت
1 BTC بیت کوین ارز دیجیتال فعال
2 ETH اتریوم ارز دیجیتال فعال
3 DOGE دوج کوین ارز دیجیتال فعال
4 LTC لایت کوین ارز دیجیتال فعال
5 XRP ریپل ارز دیجیتال فعال
6 BCH بیت کوین کش ارز دیجیتال فعال
7 XMR مونرو ارز دیجیتال فعال
8 IRR ریال ایران ارز پایه فعال
9 USD دلار آمریکا ارز پایه فعال
10 EUR یورو ارز پایه فعال
11 GBP پوند انگلیس ارز پایه فعال
12 CAD دلار کانادا ارز پایه فعال
13 AUD دلار استرالیا ارز پایه فعال
14 AED درهم امارات ارز پایه فعال
15 TRY لیر ترکیه ارز پایه فعال
16 CNY یوان چین ارز پایه فعال
17 JPY ین ژاپن ارز پایه فعال

نرخ ارز ها:

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

مشخصات:

- آدرس: api/currency/rates

- نوع درخواست: GET

دیتا مدل خروجی (فیلد result):
ردیف نام فیلد نوع فیلد اجباری شرح
1 pair string * نمایانگر مارکت
2 sellRate number * قیمت فروش
3 buyRate number * قیمت خرید
4 averageRate number * قیمت متوسط

تبدیل واحد ها:

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

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

مشخصات:

- آدرس: api/currency?:base&:target&:value

- نوع درخواست: GET

- نوع دیتا: JSON

دیتا مدل خروجی (result):

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