رفتن به محتوای اصلی

انتقال بانکی (پل، پایا، ساتنا)

علاوه بر کارت‌به‌کارت، پرداخت با انتقال به شبا هم بگیرید: کارت با شبا، حساب بدون کارت، تنظیم روش‌های پرداخت، انواع انتقال و مهلت انتظار انتقال.

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

کارت‌ها و حساب‌ها

هر پرداخت به یک مقصد می‌رود. مقصدها را در داشبورد از بخش کارت‌ها و حساب‌ها اضافه کنید (مالک و مدیر):

  • کارت، با شمارهٔ کارت و در صورت تمایل شبای حساب پشت آن. کارت بدون شبا فقط کارت‌به‌کارت می‌گیرد؛ با شبا انتقال بانکی هم می‌گیرد.
  • حساب، با شبا و بدون کارت، مثل حساب شرکت. بانکش از روی شبا خوانده می‌شود. فقط انتقال بانکی می‌گیرد.

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

کارت‌ها و حساب‌ها
ردچرا
شبایی که رقم‌های کنترلش درست نیستیک رقم اشتباه تایپ شده است.
card.iban_bank_unknownکد بانک داخل شبا به هیچ بانک شناخته‌شده‌ای نمی‌رسد.
card.iban_existsکارت یا حساب دیگری از همین کسب‌وکار و همین حالت این شبا را دارد. هر حساب یک مقصد دارد تا واریزهایش هیچ‌وقت میان دو مقصد تقسیم نشوند. مقصد بایگانی‌شده‌ای که هنوز منتظر واریزی است، شبایش را تا بسته شدن آن پرداخت نگه می‌دارد.
card.pan_forbiddenحساب شمارهٔ کارت نمی‌گیرد. به‌جایش یک کارت اضافه کنید.
card.iban_immutableشبای حساب هیچ‌وقت عوض نمی‌شود. آن را بایگانی کنید و حساب تازه‌ای اضافه کنید.
card.iban_in_useشبای کارت را می‌شود اضافه، عوض یا حذف کرد، مگر تا وقتی یکی از پرداخت‌هایش هنوز انتقال بانکی را پیشنهاد می‌دهد.

وقتی بانک کارت با بانک شبایش فرق دارد (مثلاً بعد از ادغام بانک‌ها)، داشبورد هشدار می‌دهد ولی هر دو را می‌پذیرد.

روش‌های پرداخت

در تنظیمات صفحهٔ پرداخت، در بخش راه‌های پرداخت مشتری، روش‌هایی را که می‌پذیرید انتخاب می‌کنید: کارت‌به‌کارت، انتقال بانکی یا هر دو (پیش‌فرض). دست‌کم یکی روشن می‌ماند.

  • هر پرداخت روش‌هایی را می‌پذیرد که شما روشن کرده‌اید و مقصدش پشتیبانی می‌کند، با نام payment_method_types. این فهرست هنگام ساخت پرداخت ثابت می‌شود: شبایی که بعداً اضافه شود به پرداخت‌های باز نمی‌رسد.
  • روش تقسیم شما فقط مقصدهایی را انتخاب می‌کند که یکی از روش‌های روشن را بپذیرند. card که روی پرداخت یا لینک پرداخت نام می‌برید می‌تواند کارت یا حساب باشد، ولی باید یکی از آن روش‌ها را بپذیرد (payment_card_invalid). اگر هیچ مقصدی نباشد، پرداخت ساخته نمی‌شود (card_none_available).
  • صفحهٔ پرداخت برای هر روشی که پرداخت می‌پذیرد یک زبانه دارد و هر وقت کارت را بپذیرد، کارت‌به‌کارت اول است. صفحهٔ پرداخت را ببینید.

انواع انتقال

رسید، ادعای واریز و واریز همه channel را می‌گویند، یعنی راهی که پول از آن آمده است:

انواع انتقال
channelنوعمعمولاً
cardکارت به کارتمعمولاً فوری.
polپلمعمولاً فوری.
payaپایابا چرخه‌های پایا می‌نشیند، گاهی تا روز کاری بعد.
satnaساتنامعمولاً برای مبلغ‌های بزرگ‌تر، در ساعت‌های کاری بانک‌ها.
internalانتقال داخلیمعمولاً فوری، میان دو حساب یک بانک.

این توضیح‌ها عمداً کلی‌اند: فقط بانک مشتری است که دقیق می‌داند.

سقف‌ها و ساعت‌ها

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

  • به خاطر مبلغ یا زمان هیچ چیزی پنهان، غیرفعال یا رد نمی‌شود و هیچ گزینه‌ای از پیش انتخاب نمی‌شود؛
  • رسیدی که مشتری می‌فرستد، هر نوع انتقالی را که نام ببرد، همیشه پذیرفته می‌شود: او پول را فرستاده است؛
  • تطبیق خودکار پیامک بانک، هر نوع انتقالی که گفته شده باشد، تا پایان مهلت اضافهٔ پرداخت ادامه دارد.

تنها راهنمایی ملایم است. وقتی مبلغی برای کارت‌به‌کارت زیاد به نظر برسد، زبانهٔ کارت در صفحهٔ پرداخت می‌گوید شاید انتقال بانکی راحت‌تر باشد، و زبانهٔ انتقال بانکی نوع‌هایی را که شاید به این مبلغ بخورند «پیشنهادی» علامت می‌زند. API همین راهنمایی را با نام suggestion در مدل نمایش صفحهٔ پرداخت می‌دهد و هیچ چیز دیگری نمی‌دهد.

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

مهلت انتظار انتقال

انتقال پایا یا ساتنا ممکن است مدتی طول بکشد تا بنشیند. وقتی مشتری می‌گوید با پایا یا ساتنا پرداخت کرده، پرداخت دست‌کم به اندازهٔ مهلت انتظار انتقال شما بعد از آن لحظه منتظر پیامک بانکِ همان واریز می‌ماند: به‌طور پیش‌فرض ۴۸ ساعت، از یک ساعت تا هفت روز، در تنظیمات صفحهٔ پرداخت. هر پرداخت مهلتی را که با آن ساخته شده نگه می‌دارد.

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

تطبیق انتقال بانکی

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

در API

در API
شیءفیلدتوضیح
paymentpayment_method_types["card"]، ["transfer"] یا هر دو.
paymentdestination.typecard یا account.
paymentdestination.iban_last4چهار رقم آخر شبا، یا null.
paymentdestination.ibanشبای کامل، فقط با کلید مخفی؛ وقتی پرداخت انتقال بانکی را نمی‌پذیرد null است.
paymentdestination.pan، destination.last4برای حساب null.
cardtype، iban_last4حساب یک شیء card با type: "account" و last4: null است.
depositchannelcard، pol، paya، satna، internal، یا وقتی معلوم نیست null. POST /v1/deposits و POST /v1/test_helpers/deposits آن را می‌گیرند.
accountcapabilities.bank_transferتنظیمات شما انتقال بانکی را می‌پذیرد.

خروجی پرداخت‌ها ستون methods و خروجی واریزها ستون channel دارد. وب‌هوک‌ها هرگز شمارهٔ کارت یا شبا ندارند.