مقدمه

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

پیش از شروع 

آدرس فراخوانی سرویس ها

https://api.pod.ir/srv/sc/nzh/doServiceCall

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

Header درخواست ها

پارامترهای زیر در Header تمام درخواست ها ثابت است

پارامتر

توضیحات

_token_

API token دریافتی از پنل کسب و کاری

_token_issuer_

این پارامتر دارای مقدار ثابت "1" می باشد

Content-Type

مقدار ثابت application/x-www-form-urlencoded

به UnderLine قبل  و بعد از نام پارامترها دقت نمایید

Body درخواست ها

همچنین پارامترهای زیر در Body درخواست ها نیز ثابت است

پارامتر

توضیحات

ScProductId

شناسه سرویس

ScApiKey

API Key دریافتی برای سرویس مورد نظر از پنل کسب و کاری

 

برای دریافت API KEY از طریق پنل کاربری پادیوم اقدام نمایید.

ارسال درخواست فعالسازی از سایت پادیوم و دریافت کلید از طریق پنل کسب وکار

  • توجه داشته باشید که درخواست از سایت ، برای سرویسهایی است که در حال حاضر در بازارچه موجود می باشند

فهرست

پرداخت از طریق درگاه (پرداخت با کیف پول پاد _پی پاد) کارت شتابی) 3 

ساخت لینک با استفاده از شماره انحصاری.. 6

ساخت لینک پرداخت (مخصوص کاربر ) با استفاده از شماره فاکتور 7

ساخت لینک پرداخت با استفاده از شناسه فاکتور  توسط سرویس  - 29815. 8

پرداخت فاکتور از طریق کیف پول توسط API 11

پرداخت فاکتور متعلق به خود  - 30382. 11

پرداخت هر فاکتوری   - 29821. 13

پرداخت فاکتور با پیامک -  29807. 15

تایید  پرداخت با پیامک  (از طریق کیف پول غیر پاد )  -  369550. 18

سایر روش های پرداخت فاکتور 20

پرداخت فاکتور، خارج از پلتفرم پاد - 29799. 20

پرداخت فاکتور، از طریق فاکتور - 29800. 22

پرداخت فاکتور، در آینده- 29802. 24

خرید/ پرداخت از پایانه فروشگاه-  سرویس پرداخت با POS  - 29801. 26

ارسال لینک پرداخت فاکتور به کاربر دیگر - 1113426. 28

 

معرفی درگاه پرداخت پاد (پرداخت از کیف پول پاد (پی پاد) و کارت شتابی)

 

 

 

 

 

توجه داشته باشید که :

 در درگاه این امکان وجود دارد که برای پرداخت ،علاوه بر استفاده  از کیف پول و کارت بانکیمی توان از  اعتبار اختصاصی (تخصیص داده شده به شما ) و بن تخفیف نیز  جهت پرداخت کامل یا بخشی از مبلغ فاکتور استفاده کرد .

* جهت پرداخت از کیف پول ، باید گزینه " وارد پی پاد شوید " را انتخاب نمایید و از اطلاعات ورود کاربر یا کسب وکار خود را جهت ورود به درگاه پاد با ادرس https://pay.pod.ir/استفاده نمایید.

* در انتها کاربر پرداخت کننده فاکتور ، بعد از چند ثانیه یا با فشردن دکمه "تکمیل فرایند خرید" به آدرسی که در redirectUri مشخص شده است ، همراه با اطلاعات تراکنش و پرداخت شامل: (billNumber&paymentBillNumber&invoiceId&paid&terminalId&maskedCardNumber) هدایت میشود،

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

 

javascript

 

billNumber  : شماره قبض که  توسط خود کسب و کار در سرویس صدور فاکتور ارسال شده است. 

paymentBillNumber: شماره پرداخت

invoiceId  : شناسه فاکتور

paid :   در صورتی که درصدور فاکتور پارامتر verificationNeeded مقدار true داشته باشد ( پرداخت سه مرحله ای فعال شده است.) این مقدار false است . تا اینکه پرداخت توسط صادر کننده فاکتور( کسب وکار )  تایید شود. )، در غیر این صورت پس از یک ساعت، پول پرداخت شده به کیف پول کاربر برمی گردد.

terminalId   مقدار terminalId فقط در صورتی پر می شود که پارامتر wallet مقداری بجز PODLAND_WALLET داشته باشد.

maskedCardNumberبخشی از شماره کارت پرداخت کننده

مقدار (rrn (reference number of shaprak transaction-شناسه انتقال وجه شاپرک، نیز به آدرس برگشت برگردانده خواهد شد.

tref : مقدار tref شماره پیگیری تراکنش شاپرکی می باشد

* توجه داشته باشید که کاربر برای فاکتورهای بالاتر از 10000 ریال (هزار تومان) میتواند از گزینه "پرداخت با کارت شتابی " استفاده نماید.

 در غیر این صورت با تولید یک خطا به آدرسی که در  redirectURLمشخص کرده اید ،  هدایت میشود .

 

جهت پرداخت مبلغ فاکتور با حساب دیجیتال ( کیف پول  ) سه حالت وجود دارد:

1. مشتری حتما وارد سامانه احراز هویتیکپارچه (SSO) در وب شده و از طریق درگاه پاد، گزینهی کیف پول را انتخاب نماید.

2. کسب و کار با توکن ثابت خودش از کیف پول خود، مبلغ فاکتور را با API پرداخت نماید

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

 

جهت پرداخت برای درگاه امکان تولید لینک ورود به درگاه به 3 طریق وجود دارد که در ادامه توضیحات کامل تری داده خواهد شد :

http

 

* توجه داشته باشید که تنها در  لینکپرداخت ایجاد شده توسط pbc/payinvoiceباید پرداخت کننده ی فاکتور ، همان شخصی باشد که فاکتور به نام او ایجاد شده است.

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

 توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .

 

http

 

 

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

شناسه سرویس : ندارد ( یک قالب لینک است )

توضیحات :

* دراینجایک لینکجهت پرداخت در درگاه ،  به همراه پارامترهای موجود در بخش QueryString آن  قرار داده میشود .

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

* از این لینک  جهت پرداخت در درگاه و با استفاده از  کیف پول پادی (پی پاد )  و همینطور کارت شتابی استفاده میشود.

* اگر مقدار uniqueNumber اشتباه ارسال شود، با خطای "صفحه یافت نشد" مواجه می‌شوید.

مدت اعتبار لینک بلند مدت است .

* با استفاده از این لینک ، نیازی نیست که در حین صدور فاکتور ، کاربر فاکتور (فیلد userId) وارد شده باشد.

* با استفاده از این لینک ، میتوان هر فاکتوری که userId متفاوتی داشته باشد را نیز پرداخت کرد.

توضیحات

مقدار

نام پارامتر

ورودی

Header

 https://pay.pod.ir/v1/pbc/payInvoiceByUniqueNumber

URL

GET

method

Params

uniqueNumber  بعد از صدور فاکتور در پاسخ ، دریافت میشود.

 

uniqueNumber

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

پس از پرداخت پارامترهای زیر به صورت GET به آدرس redirectUri برگردانده می شود:

billNumber&paymentBillNumber&invoiceId&paid&terminalId&maskedCardNumber

 

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

 

redirectUri

اگرPEP ارسال شود ، کاربر جهت پرداخت مستقیما وارددرگاه شاپرکی میشود،

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

PEP  ,LOC

gateway

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

پارامتر callUri نیز آدرسی در سرور شما میتواند باشد که در صورت موفق بودن پرداخت فراخوانی می گردد.

 

The function that will be called at the end of payment

callUri

لینک پرداخت نهایی

 

http

 

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

227

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

378

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

       

 

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

شناسه سرویس : ندارد ( یک قالب لینک است )

توضیحات :

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

* دراینجایک لینکجهت پرداخت در درگاه ،  به همراه پارامترهای موجود در بخش QueryString آن  قرار داده میشود .

مقدارinvoiceId، مقداری است که از پاسخ سرویس صدور فاکتور ، در فیلد با  عنوان id دریافت می‌نمایید

و این مقدار از billNumber که توسط خود کسب و کار انتخاب شده است، متمایز می‌باشد.

در این لینک ، پرداخت کننده ی فاکتور ، باید کاربری (مشتری ) باشد ، که فاکتور به نام او صادر شده است (در سرویس صدور فاکتور در فیلد userId شناسه کاربر وارد شده باشد)، در غیر این صورت کاربر با خطای " فاکتور یافت نشد " مواجه می شود.

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

 

توضیحات

مقدار

نام پارامتر

ورودی

Header

 https://pay.pod.ir/v1/pbc/payinvoice/

URL

GET

method

Params

* الزامی - شناسه فاکتور ، که بعد از صدور فاکتور در فیلد id دریافت میشود.

 

invoiceId

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

 کاربر  بعد از پرداخت کاربر به این آدرس  هدایت می گردد .

پس از پرداخت پارامترهای زیر به صورت GET به آدرس redirectUri برگردانده می شود:

billNumber&paymentBillNumber&invoiceId&paid&terminalId&maskedCardNumber

 

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

 

redirectUri

اگرPEP ارسال شود ، کاربر جهت پرداخت مستقیما وارددرگاه شاپرکی میشود،

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

PEP  ,LOC

gateway

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

 

The function that will be called at the end of payment

callUri

لینک پرداخت نهایی

 

http

 

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

227

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

378

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

       

پرداخت فاکتور از طریق کیف پول تسوط API 

پرداخت هر فاکتوری

شناسه سرویس :  29821 (سندباکس : 39317 )

توضیحات :

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

- دقت نمایید مقادیر لیستی به صورت urlencoded ارسال شوند.

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

)* کسب وکار نمیتواند برای کاربر خود فاکتور صادر کند ، ولی میتواند فاکتورهای بدون کاربر که خود صادر میکند را پرداخت کند.)

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

userAccess token/or/

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس: 29821 (سندباکس : 39317 )

29821

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

* الزامی - شناسه فاکتور ، که بعد از صدور فاکتور در فیلد id دریافت میشود.

 

invoiceId

* الزامی -  کیف پول پاد (مقدارثابتPODLAND_WALLET )  در صورت ارسال نکردن خطای زیر را دریافت میکنید

errorCode": 193,

"message": "کد حساب دیجیتال را وارد نکرده اید"

PODLAND_WALLET

wallet

لیست شناسه کاربری تفویض کننده (userId)؛

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

 

delegatorId

لیست کد hash اعتبارات ;

که دقیقا اعتبار مورد نظر را مشخص می نماید.

 

delegationHash

پرداخت فقط از طریق تفویض - در صورتی که true باشد، پرداخت حتما و فقط از اعتبارات صورت میگیرد و در صورت عدم کفایتیا عدم تطابق اعتبارات با فاکتور، خطا برگردانده می شود. در صورت ارسال false، مبلغ باقیمانده از کیف پول پرداخت می گردد.

true/false

forceDelegation

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

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

string

result

نمونه درخواست

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

24

BILL_ALREADY_PAYED - در صورتی که فاکتور قبلا پرداخت شده باشد، با این خطا مواجه می گردید.

32

INVOICE_IS_CANCELED - اگر فاکتوری که کنسل شده است را در این سرویس فراخوانی کنید، این خطا را دریافت خواهید نمود. بدیهی است فاکتوری که کنسل شده است قابل پرداخت نیست.

45

BILL_ALREADY_CLOSED - اگر فاکتور بسته شده باشد، قابل پرداخت نیست.

58

BILL_IS_WAITING_FOR_VERIFICATION - اگر فاکتور به صورت تایید دو مرحله ای صادر شده باشد و پرداخت شده باشد اما منتظر تایید باشد، با این خطا رو به رو می شوید

72

BILL_IS_WAITING_FOR_GATEWAY -  توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .

https://yourRedirectUrl.ir/path/?errorResult=

{"hasError":true,"errorCode":72,"message":"قبض منتظر درگاه   برای  ادامه  تراکنش  می  باشد","count":0}

193

 در صورت ارسال نکردن پارامتر wallet این خطا را دریافت میکنید .  "کد حساب دیجیتال را وارد نکرده اید",

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

     
 

 

پرداحت فاکتور با پیامک

شناسه سرویس :  29807  (سندباکس : 39302 )

توضیحات :

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

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

 

* دقت شود فاکتور باید به نام کاربر صادر شده باشد. (چرا که برای فاکتور بدون مشتری نمی توان پیامک ارسال کرد).

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

* لازم به ذکر است امکان انتخاب ارسال کد یا استفاده از لینکدرگاه ، در پیامک ارسالی، از طریق پارامتر smsContentType در سرویس‌ پرداخت فاکتور با پیامک فراهم گردیده است.

 

 به عنوان مثال در صورت ارسال مقدار 3 در پارامتر smsContentType، پیامکی حاوییک کد و یک لینک پرداخت برای کاربر ارسال می‌گردد.

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

 

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

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

 

* توجه نمایید که پاسخ به پاد پیامک زده میشود ، در نتیجه نیازی به فراخوانی سرویس " تایید کد " توسط کسب وکار وجود ندارد .

*  پیامکی حاوی متن زیر به شماره موبایل کاربر ارسال میشود : 

*سرزمین هوشمند پاد*

(نام کسب وکار صادرکننده فاکتور) برای شما فاکتور شماره (شناسه فاکتور) به مبلغ (مبلغ+مالیات ریال) صادر نموده است .

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

http://tilin.ir/...

 

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

userAccess token/or/

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس : 29807  (سندباکس : 39302 )

29807

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

* الزامی - شناسه فاکتور صادر شده برای کاربر، که بعد از صدور فاکتور در فیلد id دریافت میشود.

 

invoiceId

1- ارسال کد

2- ارسال لینک پرداخت

3- ارسال کد و لینک پرداخت

1 / 2 / 3

smsContentType

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

 

redirectUri

 

 

callbackUri

لیست شناسه کاربری تفویض کننده (userId)؛

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

 

delegatorId

لیست کد hash اعتبارات ;

که دقیقا اعتبار مورد نظر را مشخص می نماید.

 

delegationHash

پرداخت فقط از طریق تفویض - در صورتی که true باشد، پرداخت حتما و فقط از اعتبارات صورت میگیرد و در صورت عدم کفایتیا عدم تطابق اعتبارات با فاکتور، خطا برگردانده می شود. در صورت ارسال false، مبلغ باقیمانده از کیف پول پرداخت می گردد.

true/false

forceDelegation

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

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

string

result

نمونه درخواست

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

24

BILL_ALREADY_PAYED - در صورتی که فاکتور قبلا پرداخت شده باشد، با این خطا مواجه می گردید.

32

INVOICE_IS_CANCELED - اگر فاکتوری که کنسل شده است را در این سرویس فراخوانی کنید، این خطا را دریافت خواهید نمود. بدیهی است فاکتوری که کنسل شده است قابل پرداخت نیست.

45

BILL_ALREADY_CLOSED - اگر فاکتور بسته شده باشد، قابل پرداخت نیست.

58

BILL_IS_WAITING_FOR_VERIFICATION - اگر فاکتور به صورت تایید دو مرحله ای صادر شده باشد و پرداخت شده باشد اما منتظر تایید باشد، با این خطا رو به رو می شوید

72

BILL_IS_WAITING_FOR_GATEWAY -  توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .

https://yourRedirectUrl.ir/path/?errorResult=

{"hasError":true,"errorCode":72,"message":"قبض منتظر درگاه   برای  ادامه  تراکنش  می  باشد","count":0}

193

 در صورت ارسال نکردن پارامتر wallet این خطا را دریافت میکنید .  "کد حساب دیجیتال را وارد نکرده اید",

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

 

 

 

 

تایید پرداخت با پیامک (از طریق کیف پول غیر پاد)

شناسه سرویس :  369550 

توضیحات :

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

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

userAccess token/or/

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس : 369550 

369550 

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

* الزامی - شناسه فاکتور ، که بعد از صدور فاکتور در فیلد id دریافت میشود.

 

invoiceId

کد فعالسازی که در سرویس قبل به کاربر ارسال شده است .

 

code

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

string

result

نمونه درخواست

curl 

 

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

24

BILL_ALREADY_PAYED - در صورتی که فاکتور قبلا پرداخت شده باشد، با این خطا مواجه می گردید.

32

INVOICE_IS_CANCELED - اگر فاکتوری که کنسل شده است را در این سرویس فراخوانی کنید، این خطا را دریافت خواهید نمود. بدیهی است فاکتوری که کنسل شده است قابل پرداخت نیست.

45

BILL_ALREADY_CLOSED - اگر فاکتور بسته شده باشد، قابل پرداخت نیست.

58

BILL_IS_WAITING_FOR_VERIFICATION - اگر فاکتور به صورت تایید دو مرحله ای صادر شده باشد و پرداخت شده باشد اما منتظر تایید باشد، با این خطا رو به رو می شوید

72

BILL_IS_WAITING_FOR_GATEWAY -  توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .

https://yourRedirectUrl.ir/path/?errorResult=

{"hasError":true,"errorCode":72,"message":"قبض منتظر درگاه   برای  ادامه  تراکنش  می  باشد","count":0}

193

 در صورت ارسال نکردن پارامتر wallet این خطا را دریافت میکنید .  "کد حساب دیجیتال را وارد نکرده اید",

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

سایر روش های پرداخت فاکتور 

پرداخت فاکتور ، خارج از پلتفرم پاد

شناسه سرویس :   29799 (سندباکس : 39294 )

توضیحات :

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

 

* در این روش هیچ گونه سند مالی در پلتفرم ثبت نشده و به اعتبار افزوده نمی شود.

 

* دقت نمایید که کسب و کار فقط می تواند فاکتورهایی که خودش صادر نموده را با این روش، به حالت پرداخت شده درآورد.

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس : 29799 (سندباکس : 39294 )

29799

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

* الزامی - شناسه فاکتور ، که بعد از صدور فاکتور در فیلد id دریافت میشود.

 

invoiceId

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

string

result

نمونه درخواست

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

24

BILL_ALREADY_PAYED - در صورتی که فاکتور قبلا پرداخت شده باشد، با این خطا مواجه می گردید.

32

INVOICE_IS_CANCELED - اگر فاکتوری که کنسل شده است را در این سرویس فراخوانی کنید، این خطا را دریافت خواهید نمود. بدیهی است فاکتوری که کنسل شده است قابل پرداخت نیست.

45

BILL_ALREADY_CLOSED - اگر فاکتور بسته شده باشد، قابل پرداخت نیست.

58

BILL_IS_WAITING_FOR_VERIFICATION - اگر فاکتور به صورت تایید دو مرحله ای صادر شده باشد و پرداخت شده باشد اما منتظر تایید باشد، با این خطا رو به رو می شوید

72

BILL_IS_WAITING_FOR_GATEWAY -  توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .

https://yourRedirectUrl.ir/path/?errorResult=

{"hasError":true,"errorCode":72,"message":"قبض منتظر درگاه   برای  ادامه  تراکنش  می  باشد","count":0}

193

 در صورت ارسال نکردن پارامتر wallet این خطا را دریافت میکنید .  "کد حساب دیجیتال را وارد نکرده اید",

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

پرداخت فاکتور ، از طریق فاکتور

شناسه سرویس :   29800 ( سندباکس : 39295 )

توضیحات :

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

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

فرض کنید کسب و کار A فاکتوری را برای کسب و کار B صادر میکند

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

* [ در خصوص استفاده از این سرویس به موارد زیر توجه داشته باشید ]

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

 " فاکتور بستانکار پرداخت نشده است " میدهد.

- فاکتور بدهکار شده پس از تسویه شاپرک قابل برداشت خواهد بود.

- پس از فراخوانی سرویس فوق در پاسخ دریافتی از سرویس مقدار true در result نمایش داده خواهد شد. که به معنی انجام شدن صحیح سرویس میباشد.

- اگر وضعیت فاکتور بستانکار را دریافت نمایید مقدار willBePaid  در پاسخ سرویس برای فاکتور مربوطه true میباشد.

-پس از پرداخت شدن فاکتور، اگر وضعیت فاکتور بدهکار را دریافت نمایید مقدار willBeBlocked  در پاسخ سرویس برای فاکتور مربوطه true میباشد.

"willBePaid": true وضعیت فاکتور بستانکار

"willBeBlocked": trueوضعیت فاکتور بدهکار

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس29800 ( سندباکس : 39295 )

29800

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

شماره فاکتور بستانکار شده

invoiceId

creditorInvoiceId

شماره فاکتور بدهکار شده

invoiceId

debtorInvoiceId

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

string

result

نمونه درخواست

json

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

 

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

 

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

 

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

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

  پرداخت فاکتور ، در آینده

شناسه سرویس :   29802 ( سندباکس : 39297 )

توضیحات :

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

 

این سرویس باید توسط کسب و کار یا کاربر بدهکار یا شخصی که فاکتور برایش صادر شده صدا زده شود در غیر این صورت با خطای زیر روبرو خواهد شد.

"errorCode": 99, "message": "فاکتور برای شما صادر نشده است",

 

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

 

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

 

تــــوجه : پلتفرم پاد پرداخت شدن تمامی فاکتورهای از این دست را در سررسیدهای تعیین شده  تضمین مینماید.

 

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

 

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

 

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

همچنین در هر زمان با دریافت وضعیت فاکتور میتوانید ببینید تاریخ پرداخت تعهد شده چه تاریخی میباشد که در فیلدwillBePaidAt  به شکل timestamp  قابل مشاهده میباشد.

 

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

 

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس: 29802 ( سندباکس : 39297 )

29802

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

شماره فاکتوری که میخواهید در آینده پرداخت نمایید

 

invoiceId

تاریخ  خیامی که میخواهید در آن روز فاکتور پرداخت شود

yyyy/mm/dd

date

کد صنف که اگر وارد شود نیازی به ارسال کد کیف پول نیست

 

guildCode

کد کیف پول که در صورتی که وارد شود نیازی به کد صنف نیست و مقدار ثابت PODLAND_WALLET را خواهد داشت

PODLAND_WALLET

wallet

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

string

result

نمونه درخواست

json

 

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

 

 

 

 

 

 

خرید/ پرداخت از پایانه فروشگاه-  سرویس پرداخت با POS 

شناسه سرویس :   29801 ( سندباکس : 39296 )

توضیحات :

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

 

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

 

سایر موارد پس از تراکنش موفق از دستگاه پوز دریافت می‌گردد.

 

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

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس : 29801 ( سندباکس : 39296 )

29801

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

شماره فاکتوری که میخواهید در آینده پرداخت نمایید

 

invoiceId

شماره پایانه پرداخت

 

terminalNumber

ناسه پذیرنده پایانه پرداخت

 

merchantCode

کد کیف پول که در صورتی که وارد شود نیازی به کد صنف نیست و مقدار ثابت PODLAND_WALLET را خواهد داشت

PODLAND_WALLET

wallet

شماره مرجع فاکتور

 

referenceNumber

شماره پیگیری

 

trackingNumber

تاریخ تراکنش به فرمتyyyy/mm/dd HH:MM:ss

 

transactionDate

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

string

result

نمونه درخواست

json

 

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

ارسال لینک پرداخت فاکتور به کاربر دیگر 

شناسه سرویس :   1113426 ( سندباکس : )

توضیحات :

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

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

[private-call-address]/v1/pbc/payInvoiceByUniqueNumber?uniqueNumber=[uniqueNumber]&redirectUri=[redirectUri]

توضیحات

مقدار

نام پارامتر

ورودی

Header

توکن ثابت کسب وکار،که از پنل کسب وکار قابل دریافت است.

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

BusinessToken

_token_

این پارامتر همواره دارای مقدار ثابت 1 است .

1

_token_issuer_

این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded'  باشد

application/x-www-form-urlencoded

Content-Type

Body

شناسه سرویس : 1113426 ( سندباکس : )

1113426

scProductId

این مقدار را بعد از درخواست سرویس و تایید پادیوم ، میتوانید از پنل یا از طریق api دریافت نمایید.

کلید فراخوانی سرویس

scApiKey

سایر پارامترهای سرویس در Body

شناسه فاکتور مشتری

 

invoiceId

شناسه کاربری پرداخت کننده

 

userId

آدرس جهت انتقال کاربر پس از پرداخت

 

redirectUri

خروجی

در صورت وقوع خطا در فراخوانی سرویس true خواهد بود

true/false

hasError

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

string

referenceNumber

.پاسخ نهایی سرویس

true/false

result

نمونه درخواست

json

 

 

نمونه پاسخ

json

 

خطاهای معمول در پلتفرم

کد خطا

توضیح

21

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

227

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

378

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

999

UNKNOWN - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی)

       

 

 

 

Clasor npm package version 2.1.4
به پادیوم قدرت داده اند:
pasargad
fanap
pod