سوالات متداول
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
این صفحه اطلاعات عمومی و سوالات متداول در مورد API گوگل پی (Google Pay API) را ارائه میدهد.
درباره API گوگل پی
گوگل پی امکان پرداخت آسان را برای اپلیکیشن و وبسایت شما فراهم میکند. با استفاده از API گوگل پی، مشتریان شما میتوانند از کارتهای ذخیره شده در حسابهای گوگل خود برای پرداخت آسان در اپلیکیشنها و سایتهای شما استفاده کنند.
چگونه پشتیبانی دریافت کنیم
در کنسول Google Pay & Wallet ثبت نام کنید و گزینه تماس با پشتیبانی را انتخاب کنید. ما میتوانیم به شما در عیبیابی ادغامهایتان کمک کنیم. علاوه بر این، برای رفع اشکال ادغام خود، به راهنمای عیبیابی اندروید و راهنمای عیبیابی وب ما مراجعه کنید.
ویژگیهای پشتیبانیشده
API گوگل پی چندین ویژگی پشتیبانیشده دارد.
فرمهای پرداخت پشتیبانیشده
رابط برنامهنویسی کاربردی گوگل پی (Google Pay API) ممکن است کارتها یا توکنهای شبکه را برگرداند.
صورتحسابها و اشتراکهای دورهای
پشتیبانی از صورتحسابهای دورهای به روش پرداختی که در پاسخ API گوگل پی برگردانده میشود، وابسته است. هم کارتهای توکندار و هم کارتهای موجود در پرونده میتوانند برای صورتحسابهای دورهای استفاده شوند. برای پردازش صورتحسابهای دورهای، فروشنده نیازی به فراخوانی API ما به صورت همزمان ندارد. در عوض، اعتبار پرداخت برای پرداختهای دورهای در سمت فروشنده ذخیره میشود. فروشنده از APIهای درگاه پرداخت خود برای مدیریت صورتحسابهای دورهای استفاده میکند.
در صورت صحت موارد زیر، گوگل پی از پرداختهای دورهای پشتیبانی میکند:
بازرگانان از قوانین شبکه، مانند تراکنشهای آغاز شده توسط بازرگانان، پیروی میکنند.
شرایط پرداخت توسط کاربر در جریان خرید فروشنده افشا و پذیرفته میشود.
ما همچنین از پرداختهای دورهای با مبالغ متغیر پشتیبانی میکنیم. به عنوان مثال، از پرداختهای ماهانه تلفن همراه برای اپراتورهای تلفن همراه پشتیبانی میشود. برای کسب اطلاعات بیشتر، فروشندگان باید با نماینده درگاه پرداخت خود تماس بگیرند.
شارژ مجدد خودکار یا "اضافه کردن"
برای پردازش هزینه شارژ خودکار با همان هزینه، فروشنده لازم نیست هر بار API ما را فراخوانی کند. اعتبار پرداخت در سمت فروشنده ذخیره شده و دوباره استفاده میشود. برای کسب اطلاعات بیشتر، فروشندگان باید با نماینده درگاه پرداخت خود تماس بگیرند.
بازگشت وجه
بازرگانان میتوانند برگشت تراکنشها را برای لغو، بازپرداخت یا اختلافات، همانطور که برای سایر اشکال پرداخت، برگشت وجه را مدیریت میکنند، مدیریت کنند. برای کسب اطلاعات بیشتر، بازرگانان باید با نماینده پردازشگر خود تماس بگیرند.
جمعآوری کمکهای مالی
سازمانهای غیرانتفاعی (NPO) تأیید شده میتوانند API گوگل پی را برای جمعآوری کمکهای مالی ادغام کنند، اگر و فقط اگر مدارکی برای اثبات، تأیید و اعتبارسنجی وضعیت غیرانتفاعی خود ارائه دهند. به عنوان مثال، سازمانهای غیرانتفاعی ایالات متحده برای واجد شرایط بودن باید مدرک وضعیت 501(c)3 معتبر از اداره مالیات (IRS) ارائه دهند.
شرایط و ضوابط
شرایط خدمات API گوگل پی
همه فروشندگان باید با شرایط خدمات Google Pay API موافقت کرده و به آن پایبند باشند.
سیاست استفاده قابل قبول از API گوگل پی
همه فروشندگان باید با سیاست استفاده قابل قبول از API گوگل پی (Google Pay API) موافقت کرده و به آن پایبند باشند.
سیاست ما در مورد قمار ممکن است هر از گاهی تغییر کند. همه موارد ارسالی منوط به بررسی و تأیید هستند.
ما ادغامهای قمار را از شرکتهای مستقر در کشورهای زیر میپذیریم:
استرالیا
کانادا
چک
فرانسه
جورجیا
آلمان
یونان
مجارستان
ایرلند
ایتالیا
ژاپن
هلند
لهستان
پرتغال
رومانی
اسپانیا
سوئد
بریتانیا
در مرحلهی بعدی، ممکن است تصمیم بگیریم پشتیبانی را فراتر از سطح فعلی گسترش دهیم.
دسترسی به API گوگل پی برای یکپارچهسازی قمار در محیط عملیاتی، نیازمند تکمیل مجموعهای از پیشنیازها است:
اگر در یکی از کشورهایی که قبلاً ذکر شد، یک سیستم عامل اندروید برای قمار دارید، ابتدا باید به سیاست قمار گوگل پلی پایبند باشید و با فرآیند بررسی گوگل پلی هماهنگ شوید. سپس میتوانیم سیستم عامل اندروید شما را برای دسترسی به API گوگل پی در محیط عملیاتی ارزیابی کنیم.
اگر در یکی از کشورهایی که قبلاً ذکر شد، یک سرویس قمار آنلاین دارید، باید در طول فرآیند آشنایی با API گوگل پی، مجوز معتبری برای اثبات صلاحیت خود برای ارائه خدمات قمار در کشور ارائه دهید. سپس میتوانیم سرویس قمار آنلاین شما را برای دسترسی به API گوگل پی در محیط عملیاتی ارزیابی کنیم.
اگر در یکی از کشورهایی که قبلاً ذکر شد، یکپارچهسازی قمار اندروید و وب دارید، ابتدا باید به سیاست قمار گوگل پلی پایبند باشید و با فرآیند بررسی گوگل پلی هماهنگ شوید. سپس میتوانیم یکپارچهسازیهای اندروید و وب شما را برای دسترسی به API گوگل پی در محیط عملیاتی ارزیابی کنیم.
کشورهایی با شرایط یا محدودیتهای خاص
ادغام قمار برای کشورهای ذکر شده در صورتی مجاز است که معیارهای زیر را داشته باشند:
کشور
واجد شرایط بودن برای ادغام با اندروید
واجد شرایط بودن برای ادغام وب
بلغارستان
بله، با محدودیتهایی:
برنامههایی که به یک وبسایت هدایت میشوند واجد شرایط هستند.
برنامههایی که به وبسایت خاصی هدایت نمیشوند، ممنوع هستند.
بله
قبرس
بله، با محدودیتهایی:
قرعه کشی ایالتی واجد شرایط است.
شرکت OPAP Cyprus Limited واجد شرایط است.
کازینوهای آنلاین ممنوع است.
دستگاههای اسلات ممنوع هستند.
شرط بندی روی مسابقات اسب دوانی ممنوع است.
شرط بندی روی مسابقات سگ دوانی ممنوع است.
شرط بندی گسترده ممنوع است.
تبادل شرط بندی ممنوع است.
بله، با محدودیتهایی:
قرعه کشی ایالتی واجد شرایط است.
شرکت OPAP Cyprus Limited واجد شرایط است.
کازینوهای آنلاین ممنوع است.
دستگاههای اسلات ممنوع هستند.
شرط بندی روی مسابقات اسب دوانی ممنوع است.
شرط بندی روی مسابقات سگ دوانی ممنوع است.
شرط بندی گسترده ممنوع است.
تبادل شرط بندی ممنوع است.
فنلاند
بله، با محدودیتهایی:
وایکاوس اوی واجد شرایط است.
بله، با محدودیتهایی:
وایکاوس اوی واجد شرایط است.
قزاقستان
بله، با محدودیتهایی:
قرعهکشیها واجد شرایط هستند.
شرط بندی ورزشی واجد شرایط است.
توتالیزورها واجد شرایط هستند.
کازینوهای آنلاین ممنوع است.
کازینوهای الکترونیکی ممنوع هستند.
بله، با محدودیتهایی:
قرعهکشیها واجد شرایط هستند.
شرط بندی ورزشی واجد شرایط است.
توتالیزورها واجد شرایط هستند.
کازینوهای آنلاین ممنوع است.
کازینوهای الکترونیکی ممنوع هستند.
لهستان
خیر
بله، با محدودیتهایی:
ارائه دهندگان قمار دارای مجوز واجد شرایط هستند.
آفریقای جنوبی
بله، با محدودیتهایی:
شرط بندی ورزشی آنلاین واجد شرایط است.
بله، با محدودیتهایی:
شرط بندی ورزشی آنلاین واجد شرایط است.
اگر API گوگل پی را در کشوری که قبلاً برای آن تأیید نشدهاید، گسترش دهید، برای دریافت تأییدیه برای گسترش با ما تماس بگیرید . لطفاً توجه داشته باشید که برای هر کشوری که قصد ارائه خدمات مرتبط با قمار را در آن دارید، باید مجوز قمار مجاز ارائه دهید. ما اجازه استفاده از API گوگل پی را برای خدمات قمار در جایی که برای افراد زیر سن قانونی یا افرادی که طبق قوانین محلی از قمار منع شدهاند، در نظر گرفته شده است، نمیدهیم.
هنگام شروع به کار برای اعتبارسنجی مورد استفاده خود در حوزه سلامت، آماده باشید تا مجوز مربوطه را به اشتراک بگذارید. همه موارد ارسالی منوط به بررسی و تأیید هستند.
هنگام شروع به کار برای اعتبارسنجی مورد استفاده خدمات مالی خود، آماده باشید تا مجوز مربوطه را به اشتراک بگذارید. همه موارد ارسالی منوط به بررسی و تأیید هستند.
سوالات متداول عمومی
سوالات متداول زیر برای بازرگانان اعمال میشود:
من از یک PSP بزرگ برای مدیریت تمام ریسک و احراز هویت قوی مشتری استفاده میکنم. در مورد GPay چه چیزهایی را باید بدانم؟
رابط برنامهنویسی کاربردی گوگل پی (Google Pay API) روشهای پرداخت را در قالب یک فایل امضا شده و رمزگذاری شده برمیگرداند. روشهای پرداخت برگردانده شده شامل PAN یا کارتهای توکنیزه شده ساخته شده از PAN دستگاه (DPAN) و رمزنگاریها هستند.
بارهای کارت توکنیزه شده بدون هیچ گونه افزایش یا چالش اضافی پردازش میشوند.
بارهای کارتی که شامل PAN هستند، نیاز به 3D Secure از طریق یک راهکار داخلی یا ارائه شده توسط PSP دارند.
اگر PSP شما تمام ریسکها و منطق SCA را مدیریت میکند، مطمئن شوید که ادغام API گوگل پی شما شامل ویژگیهای زیر باشد:
merchantInfo.merchantName ( اندروید ، وب ) : نام فروشنده در برگه پرداخت نمایش داده میشود.
transactionInfo.countryCode ( اندروید ، وب ) : این نشان میدهد که تراکنش در کجا پردازش میشود. شما باید کشور بانک پذیرنده را مشخص کنید.
transactionInfo.totalPrice ( اندروید ، وب ) : کل ارزش پولی تراکنش با دقت اعشاری اختیاری دو رقم اعشار.
چگونه میتوانم شناسه تجاری گوگل (Google Merchant ID) دریافت کنم؟
پس از تأیید وبسایت شما توسط گوگل، میتوانید یک شناسه تجاری گوگل (Google Merchant ID) دریافت کنید. برای شروع این فرآیند، وارد کنسول Google Pay & Wallet شوید و یک ادغام با Google Pay API ایجاد کنید. شما باید لیستی از دامنههای کاملاً واجد شرایط به همراه زیر دامنهها ارائه دهید که به شما در فراخوانی Google Pay API کمک میکنند.
چگونه فروشندگان میتوانند پذیرش گوگل پی را در برنامهها و سایتهای خود به کاربرانشان تبلیغ کنند؟
برای برجسته کردن پشتیبانی از Google Pay، حتماً از داراییهای موجود در دستورالعملهای برند اندروید و وب ما استفاده کنید.
اگر اپلیکیشن شما با اندروید یکپارچه شده است، میتوانید در توضیحات پلی استور ذکر کنید که اکنون از گوگل پی پشتیبانی میکند. برای یکپارچهسازیهای وب، میتوانید مستقیماً توضیحاتی را به وبسایت فروشنده اضافه کنید.
آیا پلتفرمهای تجارت الکترونیک میتوانند از گوگل پی پشتیبانی کنند؟
بله، API گوگل پی از پلتفرمهای تجارت الکترونیک آنبوردینگ پشتیبانی میکند. پردازندههای پرداخت، درگاههای پرداخت یا شرکای پلتفرم تجارت الکترونیک که از طرف فروشندگان خود میزبان صفحه پرداخت هستند، میتوانند از ویژگی پرداخت میزبانیشده گوگل پی استفاده کنند.
کدام ارائه دهندگان پرداخت از Google Pay پشتیبانی میکنند؟
برای یافتن فهرستی از پردازندههایی که از Google Pay پشتیبانی میکنند، به فهرست پردازندههای Google Pay ما مراجعه کنید.
گوگل پی از چه کشورها و مناطقی پشتیبانی میکند؟
به فهرست کشورهای پشتیبانیشدهی ما که از Google Pay برای پرداختهای آنلاین یا درونبرنامهای استفاده میکنند، نگاهی بیندازید.
توکنهای گوگل پی (CRYPTOGRAM_3DS) از چه کشورها و مناطقی پشتیبانی میشوند؟
تفاوت بین پرداخت درون برنامهای گوگل پلی و API گوگل پی چیست؟
توسعهدهندگان گوگل پلی که کالاها و خدمات دیجیتال را در برنامههای اندروید میفروشند، باید از پرداخت درونبرنامهای گوگل پلی، همانطور که در مرکز سیاست توسعهدهندگان پلی مشخص شده است، استفاده کنند. نمونههایی از پرداخت درونبرنامهای شامل محصولات بازیهای مجازی، ویژگیها یا محتوای برنامه و محصولات نرمافزاری ابری است. برای کسب اطلاعات بیشتر در مورد پرداخت درونبرنامهای، به صفحه مرور کلی پرداخت درونبرنامهای گوگل پلی مراجعه کنید.
رابط برنامهنویسی کاربردی گوگل پی (Google Pay API) هنگام استفاده در برنامهها، فقط برای محصولات و خدمات فیزیکی در دسترس است.
آیا گوگل پی کارمزدی دریافت میکند؟
گوگل پی هیچ هزینه اضافی برای استفاده از API گوگل پی برای پرداختها از کاربران، بازرگانان و توسعهدهندگان دریافت نمیکند. بهطور خاص، بازرگانان همچنان هزینههای پردازش را به پردازنده پرداخت خود پرداخت میکنند.
گوگل برای اعتبارسنجی مدارک و جلوگیری از کلاهبرداری چه کاری انجام میدهد؟
تمام کارتهای اضافه شده به گوگل، برای اعتبارسنجی جزئیات کارت، که شامل کد تأیید کارت (CVC) میشود، از یک مجوز تأیید عبور میکنند. گوگل همچنین یک موتور ریسک اختصاصی را بر اساس دادههای ابزار، پروفایلهای حساب گوگل، سابقه خرید، مکانها و اطلاعات دستگاه اجرا میکند. با این حال، فروشندگان باید همچنان از ابزارهای فعلی ارزیابی ریسک و کلاهبرداری خود با تراکنشهای گوگل پی استفاده کنند.
پردازنده من در لیست نیست. آیا هنوز میتوانم با Google Pay ادغام شوم؟
گوگل پی (Google Pay) به طور مداوم در حال ایجاد همکاری با پلتفرمهای تجارت الکترونیک و پردازندههای پرداخت است. اگر نمیتوانید پردازنده خود را در g.co/pay/processors پیدا کنید، میتوانید درخواست خود را ارسال کنید . وقتی پردازنده شما در دسترس قرار گیرد، به شما اطلاع داده میشود.
اگر از قبل یک پردازنده پرداخت یا ارائه دهنده پلتفرم پرداخت دارم، چگونه میتوانم Google Pay را فعال کنم؟
گوگل پی با طیف وسیعی از ارائهدهندگان خدمات پرداخت و پلتفرمهای تجارت الکترونیک همکاری میکند. هر کدام از این ارائهدهندگان، مستندات خاص و سفارشیشدهای را برای کمک به شما در شروع کار، همراه با آموزش اصلی ما برای آشنایی آسان با سیستم، ارائه میدهند.
اگر من یک پردازنده پرداخت پشتیبانی باشم، چگونه میتوانم Google Pay را در مقیاس بزرگ به فروشندگانم ارائه دهم؟
پردازندههای پرداخت پشتیبانیشده میتوانند راهکار پرداخت میزبانیشده ما را برای ادغام با وب پیادهسازی کنند. پرداخت میزبانیشده به مشتریان شما این امکان را میدهد که گوگل پی را به مشتریان خود ارائه دهند و از آنبوردینگ فردی با گوگل پی صرفنظر کنند.
برای شروع، ابتدا باید به عنوان یک پردازنده پرداخت پشتیبانی شده وارد سیستم شوید . برای ادغام راهکار پرداخت میزبانی شده، با مسئول فنی گوگل خود که به شما در ورود به سیستم کمک کرده است، تماس بگیرید.
اگر در فرآیند پرداخت، گزینه ارسال را ارائه دهم، گوگل پی چگونه میتواند گزینههای مختلف ارسال و قیمتهای مختلف را برای کاربران من در نظر بگیرد؟
چگونه میتوانم پول حاصل از خریدهای انجام شده با Google Pay را دریافت کنم؟
رابط برنامهنویسی کاربردی گوگل پی (Google Pay API) با انتقال اطلاعات پرداخت از کاربران به ارائهدهنده خدمات پرداخت شما، تراکنشها را تسهیل میکند. این رابط در جریان پول قرار ندارد و به گونهای طراحی شده است که بر روی زیرساخت پرداخت موجود شما قرار گیرد.
چگونه میتوانم از وضعیت درخواست ادغام خود مطلع شوم و آیا پس از فرآیند بررسی شما نیاز به ایجاد تغییر دارم؟
پس از ارسال ادغام API گوگل پی برای بررسی، ایمیلی حاوی نتایج دریافت خواهید کرد. اگر ادغام شما از سیاست استفاده قابل قبول و دستورالعملهای برند ما پیروی کند، تأیید میشود و وضعیت آن در کنسول گوگل پی و کیف پول به صورت فعال نمایش داده میشود. اگر نیاز به تغییر داشته باشد، وضعیت به صورت «نیاز به اطلاعات بیشتر» نمایش داده میشود و ایمیل جزئیات مواردی را که باید قبل از ارسال مجدد اصلاح شوند، ارائه میدهد. برای هرگونه سؤالی در مورد ارسال خود، میتوانید مستقیماً از کنسول گوگل پی و کیف پول با پشتیبانی تماس بگیرید.
اگر پیام خطایی در ادغام API گوگل پی (Google Pay API) خود مشاهده کنم، چگونه میتوانم آن را عیبیابی کنم؟
برای کدهای خطای رایج و راهحلهای آنها، راهنماهای عیبیابی ما را برای اندروید و وب بررسی کنید. اگر سؤال دیگری دارید، از طریق کنسول Google Pay & Wallet با پشتیبانی تماس بگیرید.
چگونه میتوانم ادغام API گوگل پی خود را برای محدود کردن کارتها سفارشی کنم؟
تمام سفارشیسازیهای مربوط به کارتها در شیء CardParameters هم برای اندروید و هم برای وب موجود است. برای مثال، میتوانید انتخاب کنید که میخواهید کدام شبکههای کارت و کدام کشورهای صادرکننده کارت را مجاز بدانید.
API گوگل پی چیست؟
API گوگل پی به مشتریان شما این امکان را میدهد که با فشردن یک دکمه و با ذخیره روشهای پرداخت در حساب گوگل خود، پرداخت کنند. این API امکان پرداخت آسان را برای میلیونها کاربر با صدها میلیون کارت ذخیره شده فراهم میکند. این API با رمزگذاری سرتاسری دادههای پرداخت مشتری از سرورهای گوگل تا پردازنده پرداخت شما، امنیت بیشتری را ارائه میدهد. این یک فرآیند ادغام آسان است که با مجموعه پردازش پرداختهای موجود شما کار میکند و میتواند با چند خط کد پیادهسازی شود.
رابط برنامهنویسی کاربردی گوگل پی (Google Pay API) و رابط برنامهنویسی کاربردی گوگل والت (Google Wallet API) چه ارتباطی با هم دارند؟
API گوگل پی و API گوگل والت دو API جداگانه هستند. API گوگل پی به مشتریان شما اجازه میدهد از گوگل پی به عنوان روش پرداخت در وبسایت یا برنامه اندروید شما استفاده کنند. API گوگل والت به توسعهدهندگان اجازه میدهد تا کارتهای دیجیتالی را برای موارد استفاده مختلف ایجاد و مدیریت کنند. به عنوان مثال، کارتهای وفاداری، بلیطها، کارتهای دسترسی، سوابق سلامت و سایر موارد قابل تنظیم. برای کسب اطلاعات بیشتر در مورد API گوگل والت، لطفاً به مستندات توسعهدهندگان API گوگل والت مراجعه کنید.
تاریخ آخرین بهروزرسانی 2025-12-10 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-12-10 بهوقت ساعت هماهنگ جهانی."],[],["The Google Pay API allows customers to use saved cards for checkout in apps and websites. Merchants can manage recurring billing and auto-reloads by storing payment credentials and using payment gateway APIs. Nonprofits can collect donations with proper documentation. The API supports tokenized and PAN cards, with specific handling for 3D Secure. Gambling, healthcare, and financial service integrations require specific licenses and adherence to policies. Google does not charge additional fees but Merchants are still responsible for fraud, risk assessments and payment processor fees.\n"]]