پرداخت
خدمتدهنده
بازارچه پادیوم
مقدمه
خرید فعالیتی است که مشتری، محصول یا خدماتی را که توسط کسبوکاری ارائه شده است را جستجو و در ازای پرداخت هزینه استفاده میکند. در خرید آنلاین، فرآیند جستجو، تعامل فروشنده و مشتری، پرداخت و رهگیری در بستر شبکه اینترنت انجام میشود. مراحل خرید پس از انتخاب محصول توسط مشتری تا اتمام فرآیند توسط فروشنده به طور اجمالی شامل این مراحل است.
پیش از شروع
آدرس فراخوانی سرویس ها
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
پرداخت فاکتور با پیامک - 29807. 15
تایید پرداخت با پیامک (از طریق کیف پول غیر پاد ) - 369550. 18
پرداخت فاکتور، خارج از پلتفرم پاد - 29799. 20
پرداخت فاکتور، از طریق فاکتور - 29800. 22
پرداخت فاکتور، در آینده- 29802. 24
خرید/ پرداخت از پایانه فروشگاه- سرویس پرداخت با POS - 29801. 26
ارسال لینک پرداخت فاکتور به کاربر دیگر - 1113426. 28
معرفی درگاه پرداخت پاد (پرداخت از کیف پول پاد (پی پاد) و کارت شتابی)
توجه داشته باشید که :
در درگاه این امکان وجود دارد که برای پرداخت ،علاوه بر استفاده از کیف پول و کارت بانکیمی توان از اعتبار اختصاصی (تخصیص داده شده به شما ) و بن تخفیف نیز جهت پرداخت کامل یا بخشی از مبلغ فاکتور استفاده کرد .
* جهت پرداخت از کیف پول ، باید گزینه " وارد پی پاد شوید " را انتخاب نمایید و از اطلاعات ورود کاربر یا کسب وکار خود را جهت ورود به درگاه پاد با ادرس https://pay.pod.ir/استفاده نمایید.
* در انتها کاربر پرداخت کننده فاکتور ، بعد از چند ثانیه یا با فشردن دکمه "تکمیل فرایند خرید" به آدرسی که در redirectUri مشخص شده است ، همراه با اطلاعات تراکنش و پرداخت شامل: (billNumber&paymentBillNumber&invoiceId&paid&terminalId&maskedCardNumber) هدایت میشود،
و کسب وکار پس از دریافت این مقادیر در اپلیکیشنیا وبسایت خود، میتواند سایر عملیات از جمله استعلام فاکتور و تایید پرداخت را انجام دهد.
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 طریق وجود دارد که در ادامه توضیحات کامل تری داده خواهد شد :
* توجه داشته باشید که تنها در لینکپرداخت ایجاد شده توسط pbc/payinvoiceباید پرداخت کننده ی فاکتور ، همان شخصی باشد که فاکتور به نام او ایجاد شده است.
در دو روش دیگر پرداخت کننده فاکتور میتواند ، فاکتور متعلق به شخص دیگر را پرداخت نماید.
توجه داشته باشید اگر وضعیت فاکتور منتظر برای پرداخت باشد ( کاربر برای پرداخت فاکتور به درگاه شاپرکی هدایت شده باشد ولی هنوز فاکتور پرداخت نشده باشد) و مجددا سرویس پرداخت یا لینک پرداخت را اجرا کنید ، کد خطای 72 را دریافت خواهید نمود که شامل پیغام به صورت زیر است .
ساخت لینک با استفاده از شماره انحصاری | |||
شناسه سرویس : ندارد ( یک قالب لینک است ) | |||
توضیحات : * دراینجایک لینکجهت پرداخت در درگاه ، به همراه پارامترهای موجود در بخش 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 - خطای داخلی ( رفرنس نامبر خروجی ارجاع داده شود به پشتیبانی) | ||