چگونه می توان مانده حساب و نشانه ها را دانست

این راهنما نحوه درخواست یک نشانه دسترسی و نحوه بازیابی انواع مختلف اطلاعات را با استفاده از نشانه دسترسی توضیح می دهد. این برای پردازنده هایی که با یک مشتری MX کار می کنند که قبلاً یک مجوز را دریافت کرده اند ، در نظر گرفته شده است. علاوه بر این کد ، شما به API_KEY و PROCESSOR_ID نیز نیاز خواهید داشت که می توانید در داشبورد مشتری پیدا کنید.

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

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

1. یک درخواست پست را به نقطه پایانی /paym_processor_token ارسال کنید.
   • در پارامترهای رشته Query ، مجوز_code را همانطور که در مثال نشان داده شده است ، درج کنید.
   • در عنوان مجوز ، پردازنده_ید و api_key خود را درج کنید. برای اطلاعات بیشتر در مورد این عنوان ، به بخش مرجع تأیید اعتبار مراجعه کنید.

پس از دسترسی به_تک خود ، می توانید انواع اطلاعات زیر را درخواست کنید:

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

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

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

1. برای جمع آوری آخرین اطلاعات تعادل از /acciation /check_balance استفاده کنید.
2. برای خواندن اطلاعات موجود در ترازو از نقطه پایانی /paymed_account استفاده کنید.

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

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

1. درخواست پست را به نقطه پایانی /حساب /check_balance ارسال کنید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در ابتدای این راهنما بازیابی شده است ، قرار دهید.
   • این تماس اول باید با وضعیت 200 OK برگردد و یک شیء عضو را در بدن قرار دهد.
   • جمع آوری داده های تعادل مدتی طول می کشد و شما باید وضعیت کار تعادل را بررسی کنید. در ابتدا ، شما باید ببینید که میدان IS_BEING_AGGREGATED با TRUE بازگشت.

با تماس دوباره /حساب /چک_بلانس دوباره ، وضعیت کار موجودی را بررسی کنید.

• این تماس های بعدی باید با وضعیت 202 پذیرفته شده به جای 200 OK بازگردد و وضعیت فعلی عضو را شامل می شود.
• با این حال ، به خاطر داشته باشید که فقط می توانید 5 بار در هر 2 ساعت برای یک عضو خاص این نقطه پایانی را صدا کنید.

با رسیدن به حالت زیر به مرحله بعدی بروید:

• Connection_Status: متصل
• is_being_aggregated: نادرست
• به روزرسانی های موفقیت آمیز_AGGREGATED_AT به زمان فعلی.

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

1. درخواست دریافت به نقطه پایانی /پرداخت_ ACCOUNT کنید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در ابتدای این راهنما بازیابی شده است ، قرار دهید.

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

1. درخواست دریافت به /حساب /حساب_Numpers را دریافت کنید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در مرحله 1 بازیابی شده است قرار دهید.

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

1. درخواست دریافت به /account /account_owners نقطه پایانی کنید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در مرحله 1 بازیابی شده است قرار دهید.

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

1. درخواست دریافت را به نقطه پایانی /حساب /معاملات انجام دهید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در مرحله 1 بازیابی شده است قرار دهید.

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

1. درخواست دریافت به نقطه پایانی /پرداخت_ ACCOUNT کنید.
   • در عنوان مجوز ، نوع را روی Bearer تنظیم کرده و Access_Token را که در ابتدای این راهنما بازیابی شده است ، قرار دهید.

نشانه های دسترسی به فروشگاه دریافت شده از نقطه پایانی /pay_processor_token.

• برای زندگی نشانه ها قابل استفاده مجدد است. ذخیره نشانه ، پرداخت های مکرر و همچنین درخواست های عیب یابی به MX را در صورت نیاز به وجود می آورد.
• در حال حاضر ، NEVECENS ACCESS هرگز منقضی نمی شود. با این حال ، این احتمالاً تغییر خواهد کرد ، بنابراین در یک به روزرسانی آینده برای نشانه هایی با تاریخ انقضا آماده شوید.

Account_guid ، emberion_guid و user_guid مرتبط با هر نشانه دسترسی را وارد کنید.

• نشانه های دسترسی به این راهنماهای خاص تقسیم می شوند. ورود به آنها به شما امکان می دهد تا آنها را به درستی در نشانه ذخیره شده نقشه برداری کنید. این کار استفاده مجدد و مکرر را تسهیل می کند.
• این مقادیر همچنین در هنگام عیب یابی مشکلات با MX ضروری است.
• این مقادیر را می توان از مشتری بدست آورد ، و همچنین در پاسخ به نقاط پایانی پردازنده بازگردانده می شوند.
• MX در حال حاضر برای نشانه های تکراری که به همان کاربر/عضو/حساب کاربری می شوند ، بررسی نمی کند. بنابراین ، ذخیره آنها در انتهای شما و نقشه برداری مناسب به آنها کمک می کند تا از نسخه های کپی جلوگیری کنید.

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

• در صورت بروز خطایی ، MX به منظور عیب یابی به نشانه دسترسی و حساب_گید ، عضو_گید و user_guid نیاز دارد.

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

• بودجه کافی یا یک حساب بسته می تواند باعث خرابی ACH شود. اجرای یک بررسی تعادل قبل از ارسال معامله می تواند به طور خاص از جلوگیری از کدهای بازگشت ACH به طور خاص کمک کند: R01-113 صندوق های کافی ، حساب R02-61 بسته ، حساب R16-13 یخ زده.
• روند اجرای یک بررسی تعادل را می توان در راهنمای مانده حساب در زمان واقعی یا در صفحه مرجع توکن های پردازنده ما یافت.

موفقیت!

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