کارتخوان یکپارچه ابرک
پرداخت کارتی امن در صندوق اودوو، بدون برداشت تکراری
لایهٔ امن پرداخت کارتی روی صندوق فروش اودوو: مبلغ از خود سفارش، تراکنش نامشخص هرگز «رد» حساب نمیشود، تطبیق تسویه و کارمزد، فارسی و شمسی و ریالی. امروز با شبیهساز؛ کارتخوان بانکی واقعی پس از سند رسمی PSP.
کارتخوان یکپارچه ابرک چیست؟
کارتخوان یکپارچه ابرک صندوق فروش اودوو را به کارتخوان بانکی وصل میکند، طوری که هر پرداخت پیش از ارسال ثبت پایدار شود، هیچ خریدی دوبار از کارت مشتری کسر نشود و اگر پاسخ بانک نرسد، سیستم بهجای حدس زدن استعلام کند. تا دریافت سند رسمی و مجوز اولین PSP، فقط «شبیهساز ابرک» پشتیبانی میشود و هیچ کارتخوان بانکی واقعی هنوز وصل نمیشود.
- بدون برداشت تکراریتلاش دوباره = پیگیری همان تراکنش
- نامشخص ≠ ردپیام «دوباره پرداخت نکنید» + استعلام
- ریال یا تومان صریحبدون خطای دهبرابری
- تطبیق تسویهفروش کارتی ↔ کارمزد ↔ واریز بانک
چرا صندوق و کارتخوان باید یکپارچه باشند؟
وقتی مبلغ دوبار تایپ میشود، اشتباه ریال و تومان و دهبرابری رخ میدهد. بدتر از آن، اگر ارتباط وسط پرداخت قطع شود، صندوقدار نمیداند پول کسر شده یا نه و گاهی کارت مشتری دوباره کشیده میشود. کارتخوان یکپارچه این لحظه را با قاعده حل میکند، نه با حدس: هر خرید قبل از ارسال ثبت میشود و نتیجهٔ نامشخص فقط با استعلام یا شاهد روشن میشود.
راهاندازی با شبیهساز در ۵ گام
- فعالسازی اپ: «کارتخوان یکپارچه» را از فروشگاه اپ ابرک فعال کنید؛ منوهایش زیر «پایانه فروش» ظاهر میشوند.
- روشنکردن شبیهساز: «پایانه فروش ▸ پیکربندی ▸ تنظیمات»، بخش «کارتخوان ایرانی (ابرک)»، گزینهٔ «اجازهٔ شبیهساز (دمو/آموزش)».
- تعریف کارتخوان: «پایانه فروش ▸ پیکربندی ▸ کارتخوانها» ▸ جدید؛ ترکیب «شبیهساز ابرک»، کد پایانه و صندوقهای مجاز. سناریوهای بعدی (مثلاً approve,timeout_after_approval,decline) را در بخش «شبیهساز» همان فرم بنویسید.
- روش پرداخت «کارتخوان»: «پایانه فروش ▸ پیکربندی ▸ روشهای پرداخت» ▸ جدید؛ دفتر بانکی، «ادغام با: کارتخوان ایرانی (ابرک)»، همان کارتخوان و «واحد مبلغ سفارش: ریال». سپس روش را به صندوق اضافه کنید.
- پرداخت آزمایشی: صندوق را باز کنید، سفارش بزنید، «کارتخوان» را انتخاب و «ارسال» را بزنید. سناریوی قطع ارتباط پس از تأیید را هم امتحان کنید.
آموزش تصویری — قدمبهقدم (محیط دمو با شبیهساز)
صندوقدار: پرداخت با کارتخوان
مدیر: صف اقدام، تراکنشها و کارتخوانها
حسابدار: تطبیق تسویه
«حسابداری ▸ تسویهٔ کارتخوان ▸ گزارشهای تسویهٔ PSP» ▸ جدید؛ فایل CSV گزارش PSP را بارگذاری کنید (تاریخ شمسی یا میلادی، ارقام فارسی هم پذیرفته میشود) و «تطبیق با فروش کارتی» را بزنید. هر ردیف یکی از این وضعیتها را میگیرد: منطبق، اختلاف کارمزد، تسویهٔ ناقص، مغایرت ناخالص، بدون فروش متناظر، ناسازگار یا تکراری. سپس «یافتن ردیف بانک» و «ثبت کارمزد و تطبیق»: کارمزد واقعی سند بومی میخورد و خالص بهعلاوهٔ کارمزد با حساب واسط فروش صندوق تطبیق میشود.
وضعیت صادقانه و آنچه هنوز نداریم
- کارتخوان بانکی واقعی: هنوز هیچ مدل. اتصال هر PSP فقط با سند رسمی پروتکل، مجوز و آزمون روی دستگاه واقعی منتشر میشود؛ endpoint یا پروتکل بانکی را حدس نمیزنیم.
- استرداد خودکار بانکی: تا پشتیبانی PSP تأیید نشود، برگشت پول با «برگشت دستی» و شاهد ثبت میشود.
- فاکتور غیرصندوقی و کیوسک: در نقشهٔ راه؛ امروز فقط صندوق فروش.
اگر اتصال کارتخوان بانکی واقعی همین امروز شرط ورود شماست، مقایسهٔ ابرک و تسهیلگستر را ببینید؛ آنجا صریح نوشتهایم چه کسی امروز جلوتر است.
راهنماهای مرتبط
پیش از اولین نامه، دفتر دبیرخانه را درست بسازید: کد و الگوی شماره (که پس از اولین شماره قفل میشود)، تقویم شمسی، نقشها، سیاستها، فرم وب و زبان نامه. این راهنما همهٔ تنظیمها را به ترتیب نشان میدهد.
بایگانی در دبیرخانهٔ ابرک یعنی محل اصل کاغذی، امانت و بازگشت آن، سیاست نگهداری مصوب سازمان، دستور نگهداری که هر امحایی را متوقف میکند و امحای دونفره؛ بههمراه سوابق ممیزی و بستهٔ شواهد برای حسابرس.
در دبیرخانهٔ ابرک، نامهٔ صادره پیش از تأیید و امضا شمارهٔ رسمی میگیرد و PDF شمارهدارش ساخته میشود. این آموزش ترتیب درست پیشنویس، ثبت، تأیید، امضا، آمادهسازی ارسال و خواندن وضعیتهای ارسال را نشان میدهد.
پرسشهای پرتکرار دربارهی کارتخوان یکپارچه
کارتخوان یکپارچه ابرک امروز به کدام کارتخوان بانکی وصل میشود؟
امروز به هیچ کارتخوان بانکی واقعی؛ فقط «شبیهساز ابرک» فعال است. اتصال هر PSP فقط پس از دریافت سند رسمی پروتکل، مجوز و آزمون روی دستگاه واقعی منتشر میشود.
شبیهساز دقیقاً چه چیزی را نشان میدهد؟
کل گردش صندوق را با سناریوهای واقعی: تأیید، رد بانکی، قطع ارتباط پس از تأیید، کارتخوان مشغول و اختلاف مبلغ. هیچ پولی جابهجا نمیشود و هر رسید و صفحه برچسب «شبیهساز» دارد.
پیام «پاسخ نهایی دریافت نشده؛ دوباره پرداخت نکنید» یعنی چه؟
ارتباط پس از ارسال خرید قطع شده و معلوم نیست پول کسر شده یا نه. کارت را دوباره نکشید؛ «استعلام» بزنید یا صبر کنید تا استعلام خودکار نتیجه را روشن کند. تلاش دوباره روی همان سفارش خرید دوم نمیفرستد.
واحد مبلغ را کجا تعیین کنم؟
روی روش پرداخت «کارتخوان»، فیلد «واحد مبلغ سفارش» را صریحاً ریال یا تومان بگذارید (پیشفرض ریال). نام ارز شرکت مبنای تبدیل نیست.
اگر جلسهٔ صندوق تراکنش باز داشته باشد، میتوانم ببندمش؟
نه مستقیم. اول استعلام کنید؛ اگر هنوز روشن نیست، مدیر با «انتقال به صف بررسی» و شرح، جلسه را میبندد و تراکنش در صف «کارتخوان: نیازمند اقدام» میماند.
گزارش تسویهٔ PSP را با چه قالبی وارد کنم؟
CSV با ستونهای psp، terminal، business_date، unit، gross، fee، net، reference و settle_date. تاریخ شمسی (۱۴۰۵/۰۷/۰۱) یا میلادی و ارقام فارسی پذیرفته میشود؛ واحد هر ردیف IRR یا IRT است.
کارتخوان من در فهرست نیست؛ چه کنم؟
در «ماتریس سازگاری کارتخوان» فقط ترکیبهای آزمودهشده «تأییدشده» میشوند. نام PSP، مدل، نسخهٔ نرمافزار و روش اتصال دستگاهتان را برای پشتیبانی ابرک بفرستید.