پرداخت با QR code
خدمتدهنده
بازارچه پادیوم
مقدمه
یکی از روشهای پرداخت وجوه، اسکن کد QR اختصاصی کالاست. در این حالت کسبوکار شناسه پرداخت کالا را در قسمت تولید کد QR قرار میدهد و سپس تصویر QRCode تولید شده را در اختیار مشتریان خود قرار میدهد. با اسکن این تصویر، مشتری مستقیم به مرحله پرداخت منتقل میشود و میتواند با کمترین میزان اتلاف وقت، خرید خود را نهایی سازد.
فعالسازی سرویس
ارسال درخواست در سایت پادیوم www.podium.ir :
ابتدا وارد سایت پادیوم شده ، سپس در بازارچه ی API ، سرویسهای مورد نظر خود را انتخاب و درخواست استفاده از آن مجموعه سرویس را ارسال کنید.
درخواست شما توسط کارشناسان پادیوم، بررسی شده و بعد از تایید آن میتوانید از طربق پنل کسب و کار خود اقدام به دریافت کلید اتصال مربوط به آن سرویس نمایید.
منو: پنل کسب و کار – منوی میزکار سرویس گیرنده – درخواستهای ارسالی – در بخش مربوط به سرویس مورد نظر با کلیک بر روی "جزئیات درخواست"
درلیست باز شده با کلیک بر روی تصویر کلید سمت چپ هر سطر جدول میتوانید ApiKey مربوط به آن سرویس را دریافت و ذخیره کنید.
لینک پنل کسب و کار https://panel.pod.ir/Businesses/Requestwebservices
نکته : این کلید در تمام درخواستهای ارسالی از آن سرویس ، ثابت است تا زمانی که کلید جدیدی برای آن سرویس دریافت نشود و به محض دریافت مقدار جدید برای سرویس مورد نظر, کلید قبلی منقضی خواهد شد.
-این کلید در فیلد scApiKey در بخش body درخواست HTTP ، استفاده می شود.
دریافت کلیدهای سرویس یک (دسته/مجموعه) سرویس در قالب یک فایل:
بعداز فشردن دکمه ی تایید سرویس در پنجره باز شده بالا ، برای تمامی سرویسهای موجود در پنل میتوانید از گزینه "دریافت فایل خروجی"، لیست کاملی از سرویسها و کلیدهای scApiKey متناظر با هر یک را دریافت کنید.
سرویس QRCODE فاکتور
در این سرویس، شناسه فاکتور به عنوان دادهی ورودی در یک تصویر QRCode گنجانده میشود.
با ارسال پارامتر extraContent میتوانید اطلاعات مربوط به فاکتور خود را نیز در تصویر خروجی داشته باشید.توجه داشته باشید که حجم تصویر افزایش خواهد یافت.
• پارمتر الزامی در JSON ارسالی شامل invoiceId خواهد بود.
• سایر اطلاعات خود را می توانید به صورت key:value در JSON ارسالی قرار دهید.
شناسه سرویس : 3751388
(سندباکس: ندارد)
توضیحات | مقدار | نام پارامتر | |
ورودی | |||
Header | |||
توکن ثابت کسب وکار، که از پنل کسب وکار قابل دریافت است | yourBusinessToken | _token_ | |
این پارامتر همواره دارای مقدار ثابت 1 است . | 1 | _token_issuer_ | |
این پارامتر نوع داده ارسالی به سرور را مشخص میکند که همواره باید دارای مقدار ثابت application/x-www-form-urlencoded' باشد | application/x-www-form-urlencoded | Content-Type | |
Body | |||
شناسه سرویس | 3751388 | scProductId | |
کلید فراخوانی سرویس |
| scApiKey | |
اطلاعات موردنظر به شکل یک JSON {"key":"value"}
| {} | data | |
پارامترهای data | |||
الزامی – شناسه فاکتور | string | invoiceId | |
اختیاری – اگر true ارسال شود ، واگر فاکتور متعلق به صاحب token باشد ، استعلام فاکتور نیز در QRCODE گنجانده میشود . که در آن صورت باعث افزایش سایز تصویر و تعداد پیکسل ها خواهد شد . | true/false | extraContent | |
سایر پارامتر و اطلاعات دلخواه خود را میتوانید در به صورت key:value در JSON قرار دهید که در QRCODE گنجانده شود . |
| otherParams | |
خروجی | |||
در صورت وقوع خطا در فراخوانی سرویس true خواهد بود | true/false | hasError | |
جهت بررسی لاگ درخواست و ریسپانس توسط کارشناسان پادیوم ، استفاده میشود. توصیه می شود این پارامتر را برای هر درخواست ذخیره کنید. | string | referenceNumber | |
نتیجه ی نهایی سرویس | string | result.result | |
نوع تصویر که به فرمت base64 ایجاد شده است . | string | type | |
فرمت base64 تصویر qrCode | string | base64 | |
نمونه درخواست | |||
HTTP | |||
نمونه پاسخ | |||
JSON
| |||
خطاهای معمول در پلتفرم | |||
کد خطا | توضیح | ||
21 | توکن کسبوکاری وارد نشده است | ||
227 | تایم اوت سرویس اصلی | ||
378 | ارسال پاسخ از سرویس اصلی به پلتفرم با مشکل مواجه شده است | ||
1001 | فرمت دیتای ارسالی اشتباه است . |