1. 2. 5. معاملات مکرر ¶

ساخت وبلاگ

آخرین مطالب

امکانات وب

1. 2. 5. معاملات مکرر ¶

Customer -></p><p> Merchant: Pick up recurrent service activate Merchant Merchant --> Customer: Show initial payment form deactivate Merchant Customer ->

پردازش پرداخت اولیه

به منظور ثبت کارت مشتری و دریافت بازرگان کارت-ID باید با استفاده از یکی از API های زیر ، پرداخت اولیه را با PayNeteasy پردازش کند:

مهم است که پرداخت اولیه را به عنوان امن ترین راه انجام دهید تا تضمین کند که یک دارنده کارت واقعی در حال ثبت کارت است. برای اطمینان از این بازرگان ممکن است از یکی از رویکردهای شناسایی زیر یا ترکیب آنها استفاده کند: تأیید شده توسط ویزا ، MasterCard SecureCode ، تأیید خروج از مقدار تصادفی ، سیستم های ضد کلاهبرداری (به عنوان مثال MaxMind).

ثبت نام کارت ثبت نام

بازرگان باید Card-Ref-ID را دریافت کند که در پرداخت های مکرر در آینده مورد استفاده قرار می گیرد تا از ذخیره داده های حساس به کارت اعتباری که توسط PCI DSS لازم است جلوگیری شود. شناسه ثبت نام کارت کاملاً ایمن است و حتی اگر آنها آن را بدانند ، توسط کلاهبرداران برای انجام معامله کلاهبرداری OU استفاده نمی شود. این امر به شما امکان می دهد تا به طور ایمن کارت-ref-id را در مشخصات مشتری در سمت بازرگان ذخیره کنید.

کارت-Ref-ID فقط برای معامله در وضعیت نهایی قابل ایجاد است. به لیست وضعیت مراجعه کنید

برای اهداف ادغام از محیط صحنه استفاده از sandbox. payneteasy. com به جای دروازه تولید استفاده کنید. payneteasy. com. معاملات ثبت نام کارت از طریق درخواست پست HTTPS با استفاده از URL در قالب زیر آغاز می شود:

درخواست ثبت نام کارت url¶

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

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

پارامترهای درخواست ثبت نام کارت ow

پارامتر درخواست ثبت نام شرح
وارد شدن نام ورود به سیستم بازرگان
client_orderid شناسه سفارش بازرگان معامله ای که از آن درخواست می شود
شماره سفارش شناسه سفارش به سفارش توسط Payneteasy اختصاص داده شده است
کنترل Checksum برای اطمینان از این که بازرگان (و نه کلاهبرداری) است که درخواست را ارسال می کند ، استفاده می شود. این بررسی SHA-1 از ورود به سیستم Concatenation + مشتری-سفارش-ID + Paynet-Remere-ID + بازرگان-کنترل است

همانطور که ممکن است از لیست پارامترها مشاهده کنید ، بازرگان برای تهیه سفارش IDID و client_orderid مرتبط با اولین معامله پرداخت. تأکید می کند که اولین پرداخت یک گام اجباری برای پردازش پرداختهای مکرر است.

پاسخ ثبت نام کارت ¶

تمام پارامترها در پاسخ در قالب MIME MIME APPLIED/X-WWW-FORM-URLENCODED رمزگذاری می شوند

 

پارامتر پاسخ ثبت نام شرح
نوع نوع پاسخممکن است خطای ایجاد-کارت-پاسخ ، خطا ، خطا ، خطا باشد. اگر نوع برابر با اعتبار سنجی یا خطا یا خطا باشد ، پارامترهای خطا و کد خطا حاوی جزئیات خطا هستند
وضعیت برای جزئیات بیشتر به لیست وضعیت مراجعه کنید
کارت- شناسه مرجع کارت استفاده شده در پرداختهای مکرر بعدی
UNQ-CARD-Ref-ID شناسه مرجع کارت منحصر به فرد به هر تابه. این می تواند توسط بازرگان برای برنامه های وفاداری یا کنترل کلاهبرداری استفاده شود
شماره سریال شماره منحصر به فرد اختصاص داده شده توسط سرور PayNeteasy به درخواست خاص از بازرگان
پیغام خطا در صورت کاهش وضعیت یا خطا ، این پارامتر حاوی دلیل کاهش است
کد خطا کد خطا مورد کاهش یا وضعیت خطا است
انتهای نقطه ID شناسه نقطه پایانی برای معامله استفاده می شود

درخواست ثبت نام کارت جمع آوری پستچی

درخواست ثبت نام کارت اشکال زدایی

کپی به کلیپ بورد

جزئیات دارنده کارت را با شناسه مرجع کارت دریافت کنید

برای اهداف ادغام از محیط صحنه استفاده از sandbox. payneteasy. com به جای دروازه تولید استفاده کنید. payneteasy. com. بازرگانان با ارسال درخواست HTTPS به سرور ، جزئیات کارت را درخواست می کنند. به منظور ایجاد این درخواست ، بازرگان موظف است با درخواست Card-Ref-ID را منتقل کند. برای ایجاد درخواست از URL زیر استفاده کنید:

جزئیات دارنده کارت درخواست URL¶

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

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

پارامترهای درخواست اطلاعات کارت

پارامتر درخواست اطلاعات طول/نوع اظهار نظر ضرورت*
وارد شدن 20/رشته نام ورود به سیستم بازرگان اجباری
دارای فشار 20/رشته برابر با کارت-ref-id به دست آمده در تماس با شناسه مرجع اطلاعات کارت در مرحله ثبت نام کارت اجباری
کنترل 128/رشته Checksum برای اطمینان از بازرگان بودن (و نه کلاهبرداری) که درخواست بازگشت را آغاز می کند ، استفاده می شود. این بررسی sha-1 از ورود به سیستم concatenation + cardrefid + merchant_control است اجباری

پاسخ اطلاعات کارت را دریافت کنید

تمام پارامترها در پاسخ در قالب MIME MIME APPLIED/X-WWW-FORM-URLENCODED رمزگذاری می شوند

 

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

اطلاعات کارت را جمع آوری کنید

دریافت اطلاعات کارت اشکال زدایی

کپی به کلیپ بورد

فرآیند پرداخت مکرر

نمودار پرداخت مکرر موفق

Merchant -></p><p> Merchant: Start recurrent payment Merchant -> Merchant: Get card ref id from customers profile Merchant ->

برنامه بازرگان رویدادی را ایجاد می کند که نیاز به برداشت مقداری از کارت مشتری دارد

PayNeteasy وضعیت فعلی سفارش را بازگرداند. وضعیت پردازش به این معنی است که سفارش هنوز در حال پردازش است

برای اهداف ادغام از محیط صحنه استفاده از sandbox. payneteasy. com به جای دروازه تولید استفاده کنید. payneteasy. com. معاملات پرداخت مکرر از طریق درخواست HTTPS POST با استفاده از URL در قالب زیر آغاز می شود:

درخواست پرداخت مکرر url¶

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

https://gate. payneteasy. com/paynet/api/v2/make-rebill-preauth/endpointid-برای پرداخت مکرر

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

https://gate. payneteasy. com/paynet/api/v2/make-rebill/group/endpointgroupid-برای فروش مکرر پرداخت

https://gate. payneteasy. com/paynet/api/v2/make-rebill-preauth/group/endpointgroupid-برای پرداخت مکرر

پارامترهای درخواست پرداخت مکرر

پارامتر درخواست پرداخت طول/نوع اظهار نظر ضرورت*
client_orderid 128/رشته شناسه سفارش بازرگان اجباری
وارد شدن 20/رشته ورود به سیستم بازرگان اجباری
دارای فشار 20/رشته شناسه مرجع کارت به دست آمده در مرحله ثبت نام کارت اجباری
order_desc 64K/رشته توضیح سفارش اجباری
میزان 10/عددی مبلغی که باید شارژ شودمبلغ باید در بالاترین واحدها مشخص شود. حائل، جداکننده. به عنوان مثال ، 10. 5 برای USD به معنای 10 دلار و 50 سنت است اجباری
inumerate_amounts 128/رشته این پارامتر ممکن است شامل مقادیر مختلفی باشد که از هم جدا شده اند. PayNeteasy از طریق مبلغ لیست چرخه می گیرد ، سعی کنید مبلغ آن مبلغ را پرداخت کنید ، تا زمانی که مبلغ بیشتری از لیست وجود نداشته باشد ، یا تأیید نشود اختیاری
واحد پول 3/رشته ارز معامله در (کد ارز سه حرفی) شارژ می شود. نمونه ای از مقادیر پارامتر معتبر عبارتند از: دلار برای دلار آمریکا یورو برای یورو اروپا اجباری
cvv2 3-4/عددی کد CVV2 مشتری. CVV2 (مقدار تأیید کارت) پس از شماره کارت اعتباری در منطقه امضاء کارت ، یک شماره سه یا چهار رقمی است. اگر دروازه بانکی از پردازش بدون CVV2 پشتیبانی کند ممکن است خالی باشد یا غایب باشد اختیاری
آدرس آی پی 45/رشته آدرس IP مشتری ، برای اهداف غربالگری کلاهبرداری شامل می شود اجباری
کنترل 40/رشته Checksum تولید شده توسط SHA-1. این بررسی sha-1 از ورود به سیستم concatenation + client_orderid + cardrefid + مقدار_in_cents + ارز + merchant_control است اجباری
اظهار نظر 50/رشته یک نظر کوتاه اختیاری
هدف 128/رشته مقصد به جایی که پرداخت می رود. این برای بازرگانانی که به مشتریان خود اجازه می دهند پول را از کارت اعتباری به نوعی از حساب مشتری منتقل کنند ، به عنوان مثال مفید است. حساب بازی یا تلفن همراه. مقادیر نمونه عبارتند از: +7123456789 ؛gamer0001@ereality. com و غیره این مقدار توسط سیستم نظارت بر کلاهبرداری استفاده می شود اختیاری
تغییر مسیر_ورل 1024/رشته URL دارنده کارت پس از اتمام معامله هدایت می شود. لطفاً توجه داشته باشید که دارنده کارت در هر صورت هدایت می شود ، مهم نیست که معامله تصویب شود یا کاهش یابد. شما نباید از این پارامتر برای بازیابی نتایج حاصل از PayNeteasy Gateway استفاده کنید ، زیرا تمام پارامترها از طریق مرورگر مشتری می روند و در هنگام انتقال می توانند از بین بروند. به جای آن ، نتیجه پرداخت صحیح را به backend خود ارائه دهید. پارامتر برای جریان 3DS اجباری است و برای غیر 3DS اختیاری است. اگر مطمئن نیستید از http://google. com عبور کنید اختیاری
redirect_success_url 1024/رشته URL دارنده کارت پس از اتمام معامله هدایت می شود. لطفاً توجه داشته باشید که دارنده کارت فقط در صورت تأیید معامله هدایت می شود. شما نباید از این پارامتر برای بازیابی نتایج حاصل از PayNeteasy Gateway استفاده کنید ، زیرا تمام پارامترها از طریق مرورگر مشتری می روند و در هنگام انتقال می توانند از بین بروند. به جای آن ، نتیجه پرداخت صحیح را به backend خود ارائه دهید. اگر از طرحواره غیر 3DS برای پردازش معاملات استفاده می کنید http://google. com اختیاری
redirect_fail_url 1024/رشته URL دارنده کارت پس از اتمام معامله هدایت می شود. لطفاً توجه داشته باشید که دارنده کارت فقط در صورت کاهش یا فیلتر کردن معامله هدایت می شود. شما نباید از این پارامتر برای بازیابی نتایج حاصل از PayNeteasy Gateway استفاده کنید ، زیرا تمام پارامترها از طریق مرورگر مشتری می روند و در هنگام انتقال می توانند از بین بروند. به جای آن ، نتیجه پرداخت صحیح را به backend خود ارائه دهید. اگر از طرحواره غیر 3DS برای پردازش معاملات استفاده می کنید http://google. com اختیاری
server_callback_url 1024/رشته URL نتیجه معامله به آن ارسال می شود. بازرگان ممکن است از این URL برای پردازش سفارشی تکمیل معامله استفاده کند ، به عنوان مثالبرای جمع آوری داده های فروش در پایگاه داده بازرگان. جزئیات بیشتر را در تماس با Merchant مشاهده کنید اختیاری
merchant_data 64K/رشته هرگونه اطلاعات اضافی برای این معامله که ممکن است در سیستم های خارجی بازرگان مفید باشد ، به عنوان مثالمشتری VIP ، رهبری تبلیغات تبلیغاتی تلویزیون. در پاسخ به وضعیت و بازگشت به بازرگان بازگردانده می شود اختیاری
مکرر_کناریو 50/رشته نوع معامله Rebill. مقادیر ممکن: منظم یا نامنظم. اگر این پارامتر در درخواست ارسال شود ، نسبت به همان پارامتر مشخص شده در سطح دروازه اولویت دارد. فقط برای خریداران خاص استفاده می شود اختیاری
مکرر_ینیتور 50/رشته آغازگر معامله Rebill. مقادیر احتمالی: دارنده کارت یا بازرگان. اگر این پارامتر در درخواست ارسال شود ، نسبت به همان پارامتر مشخص شده در سطح دروازه اولویت دارد. فقط برای خریداران خاص استفاده می شود اختیاری

* فضای سفید پیشرو و دنباله ای در پارامترهای ورودی حذف می شود

پاسخ مکرر ¶

تمام پارامترها در پاسخ در قالب MIME MIME APPLIED/X-WWW-FORM-URLENCODED رمزگذاری می شوند

 

پارامتر پاسخ مکرر شرح
نوع نوع پاسخممکن است پاسخ async-پاسخ ، خطا ، خطا ، خطا باشد. اگر نوع برابر با اعتبار سنجی یا خطا یا خطا باشد ، پارامترهای خطا و کد خطا حاوی جزئیات خطا هستند
Paynet-Remord-ID شناسه سفارش به سفارش توسط Payneteasy اختصاص داده شده است
بازرگان-سفارش شناسه سفارش بازرگان
شماره سریال شماره منحصر به فرد اختصاص داده شده توسط سرور PayNeteasy به درخواست خاص از بازرگان
پیغام خطا اگر وضعیت خطا باشد ، این پارامتر حاوی دلیل کاهش یا جزئیات خطا است
کد خطا کد خطا مورد وضعیت خطا است

مجوز درخواست مکرر از طریق پارامتر کنترل ¶

از این چک استفاده می شود تا اطمینان حاصل شود که این یک بازرگان خاص (و نه کلاهبرداری) است که معامله را آغاز می کند. این بررسی SHA-1 ، کنترل پارامتر ، با جمع بندی مقادیر پارامترها به ترتیب زیر ایجاد می شود:

  • endpointid/endpointgroupid
  • وارد شدن
  • client_orderid
  • دارای فشار
  • حداقل واحدهای پولی حداقل (به عنوان مثال ، پنی و غیره برای مقدار 0. 94 دلار در رشته امضای 94 ، برای مقدار 10. 15 دلار در رشته امضای 1015 خواهد بود)
  • واحد پول
  • بازرگان_ کنترول

یک مثال کامل رشته ممکن است به شرح زیر باشد:

رشته را با استفاده از الگوریتم SHA-1 رمزگذاری کنید. رشته نتیجه پارامتر کنترل را به دست می آورد (به پارامترهای درخواست فروش مراجعه کنید) که برای مجوز درخواست لازم است. برای مثال فوق ، کنترل مقدار زیر را به خود اختصاص می دهد: < Pan> از چک استفاده می شود تا اطمینان حاصل شود که این یک بازرگان خاص (و نه یک کلاهبردار) است که معامله را آغاز می کند. این بررسی SHA-1 ، کنترل پارامتر ، با جمع بندی مقادیر پارامترها به ترتیب زیر ایجاد می شود:

سیگنال های تجاری...
ما را در سایت سیگنال های تجاری دنبال می کنید

برچسب : نویسنده : محسن رضایی بازدید : <-PostHit-> تاريخ : پنجشنبه 25 اسفند 1401 ساعت: 21:04

آرشیو مطالب

پيوندهای روزانه

لینک دوستان

خبرنامه