API گوگل پی: صفحه پرداخت با کد Vibe با سرورهای MCP و Antigravity

۱. مرور کلی

توسعه نرم‌افزار مدرن به سرعت از برنامه‌نویسی دستوری به سمت توسعه بومی هوش مصنوعی در حال تغییر است. در این آزمایشگاه کد، شما یاد خواهید گرفت که با استفاده از سرور MCP توسعه‌دهنده Google Pay & Wallet (که از این پس به عنوان سرور MCP گوگل پی نامیده می‌شود) و Antigravity، یک ابزار بومی هوش مصنوعی، ادغام‌های Google Pay را ایجاد و بهبود بخشید.

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

متعاقباً، شما از روش‌های توسعه مبتنی بر مشخصات برای بهبود ادغام خود با ویژگی‌های جدید API استفاده خواهید کرد - به طور خاص فعال کردن تراکنش‌های آغاز شده توسط فروشنده (MIT) برای پرداخت‌های مکرر و استفاده از سیگنال cardFundingSource برای مسیریابی و قیمت‌گذاری پویا. در نهایت، شما یک خط لوله نظارت مستقل مبتنی بر LLM را پیکربندی خواهید کرد تا مشکلات پرداخت را در طول شب مشاهده و اصلاح کنید.

آنچه یاد خواهید گرفت

• نحوه تنظیم و اتصال سرور Google Pay MCP به Antigravity یا سایر ابزارهای هوش مصنوعی
• نحوه استفاده از سرور Google Pay MCP برای جستجوی اسناد
• چگونه می‌توان یکپارچه‌سازی پرداخت گوگل پی (Google Pay) را مستقیماً در آنتی‌گراویتی (Antigravity) به بهترین شکل ممکن پیاده‌سازی کرد؟
• نحوه پیاده‌سازی مسیریابی پویا و قیمت‌گذاری با توسعه مبتنی بر مشخصات
• چگونه موارد استفاده از اشتراک‌های مکرر را با توسعه مبتنی بر مشخصات بهبود بخشیم؟
• نحوه استقرار نظارت بلندمدت و خطوط لوله خودکار عامل با استفاده از Antigravity
• نحوه پیاده‌سازی پرداخت سریع مهمان برای بهینه‌سازی قیف تبدیل

۲. تنظیمات و الزامات

قبل از اینکه شروع کنی

برای استفاده از سرور Google Pay MCP، باید یک پروژه Google Cloud ایجاد کنید و API توسعه‌دهنده Google Pay & Wallet را فعال کنید.

⚠️ هشدار : این آزمایشگاه از منابع ابری قابل پرداخت استفاده می‌کند. برای جلوگیری از هزینه‌های جاری ، مراحل پاکسازی را در پایان آزمایشگاه دنبال کنید. کاربران جدید واجد شرایط دریافت نسخه آزمایشی رایگان ۳۰۰ دلاری هستند.

1. در کنسول ابری خود، در صفحه انتخاب پروژه، یک پروژه گوگل کلود را انتخاب یا ایجاد کنید.
   به انتخابگر پروژه بروید
2. رابط برنامه‌نویسی کاربردی توسعه‌دهندگان Google Pay & Wallet را فعال کنید.
   فعال کردن API
   • برای فعال کردن APIها، به نقش IAM مدیر استفاده از سرویس ( roles/serviceusage.serviceUsageAdmin ) نیاز دارید که شامل مجوز serviceusage.services.enable است. نحوه اعطای نقش‌ها را بیاموزید .
   

نقش‌های مورد نیاز

برای دریافت مجوزهای لازم برای استفاده از سرور Google Pay MCP، از مدیر خود بخواهید که نقش‌های IAM زیر را در پروژه Google Cloud به شما اعطا کند:

• فراخوانی‌های ابزار MCP را انجام دهید: کاربر ابزار MCP ( roles/mcp.toolUser )

برای اطلاعات بیشتر، به مدیریت دسترسی به پروژه‌ها مراجعه کنید.

احراز هویت و مجوز

سرور Google Pay MCP از پروتکل OAuth 2.0 به همراه IAM برای احراز هویت و مجوزدهی استفاده می‌کند.

برای ایجاد شناسه و رمز کلاینت OAuth 2.0 برای ابزارهای MCP خود جهت دسترسی به منابع Google Cloud، این مراحل را دنبال کنید:

1. در کنسول گوگل کلود، به مسیر Google Auth Platform > Clients > Create client بروید.
   به ایجاد مشتری بروید
2. در لیست نوع برنامه ، نوع مناسب برای برنامه هوش مصنوعی خود را انتخاب کنید:
   • برای Antigravity ، Claude.ai ، Claude Code و ChatGPT ، گزینه Web application را انتخاب کنید.
   • برای Gemini CLI و VS Code ، گزینه Desktop app را انتخاب کنید.
3. در فیلد نام ، یک نام برای برنامه خود وارد کنید (برای مثال، Antigravity ).
4. در بخش Authorized redirect URIs ، روی + Add URI کلیک کنید و سپس ریدایرکت URI مورد نیاز برای برنامه هوش مصنوعی خود را اضافه کنید:
   • ضد جاذبه : https://antigravity.google/oauth-callback
   • سایر ابزارهای هوش مصنوعی : به بخش تنظیمات کلاینت OAuth مراجعه کنید.
5. روی ایجاد کلیک کنید. پس از ایجاد، به جزئیات مشتری مراجعه کنید. شناسه مشتری و رمز مشتری را کپی کنید و آنها را در جای امنی ذخیره کنید.
6. در کنسول گوگل کلود، به Google Auth Platform > Audience بروید، روی Publish app کلیک کنید و سپس برای تغییر وضعیت Publishing به In production ، روی Confirm کلیک کنید.
   به بخش مخاطبان بروید
   
   

۳. پیکربندی سرورهای MCP

اپلیکیشن هوش مصنوعی خود را پیکربندی کنید

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

ضد جاذبه ۲.۰

برای پیکربندی Antigravity 2.0 :

1. به تنظیمات > سفارشی‌سازی‌ها بروید و در زیر سرورهای نصب‌شده MCP ، روی باز کردن پیکربندی MCP کلیک کنید تا فایل پیکربندی Antigravity باز شود (مثال: ~/.gemini/antigravity/mcp_config.json ).
2. ورودی google-pay-wallet-dev را در mcpServers با شناسه کلاینت OAuth و رمز عبور خود اضافه یا به‌روزرسانی کنید ( ANTIGRAVITY_CLIENT_ID و ANTIGRAVITY_CLIENT_SECRET را با شناسه کلاینت OAuth 2.0 و رمز عبور ایجاد شده جایگزین کنید):

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }
   

3. به تنظیمات > سفارشی‌سازی‌ها بروید و در زیر سرورهای MCP نصب‌شده ، روی به‌روزرسانی (Refresh) کلیک کنید.
4. روی تأیید اعتبار کلیک کنید و جریان OAuth را تکمیل کنید:
   • اگر از شما پرسیده شد که «Google این برنامه را تأیید نکرده است» ، روی «Advanced» کلیک کنید و سپس برای ادامه روی «Go to antigravity.google (unsafe)» کلیک کنید. این هشدار به این دلیل نمایش داده می‌شود که کلاینت OAuth شما تأیید نشده است. ادامه کار در طول توسعه بی‌خطر است.
     
     
   • محدوده‌های مورد نیاز را انتخاب کنید ( مشاهده، ویرایش و حذف ادغام‌های API گوگل پی ) و سپس برای اعطای دسترسی به آنتی‌گراویتی، روی ادامه کلیک کنید.
     
5. کد مجوز را کپی کنید و کد را در پنجره کد مجوز ارسال کنید.
   

محیط برنامه‌نویسی ضد جاذبه

برای پیکربندی Antigravity IDE :

1. در Antigravity IDE، روی منوی گزینه‌های اضافی در پنل Agent > MCP Servers > Manage MCP Servers کلیک کنید.
2. در بالای پنل مدیریت سرورهای MCP، روی View raw config کلیک کنید تا فایل mcp_config.json ویرایش شود ( ANTIGRAVITY_CLIENT_ID و ANTIGRAVITY_CLIENT_SECRET را با شناسه کلاینت OAuth 2.0 و رمز ایجاد شده جایگزین کنید):

   {
     "mcpServers": {
       "google-pay-wallet-dev": {
         "serverUrl": "https://paydeveloper.googleapis.com/mcp",
         "oauth": {
           "clientId": "ANTIGRAVITY_CLIENT_ID",
           "clientSecret": "ANTIGRAVITY_CLIENT_SECRET"
         }
       }
     }
   }
   

3. به مدیریت سرورهای MCP برگردید و روی Refresh کلیک کنید. با کلیک بر روی Authenticate، برگه Customizations در تنظیمات Agent باز می‌شود.
4. روی تأیید اعتبار کلیک کنید و جریان OAuth را تکمیل کنید:
   • اگر از شما پرسیده شد که «Google این برنامه را تأیید نکرده است» ، روی «Advanced» کلیک کنید و سپس برای ادامه روی «Go to antigravity.google (unsafe)» کلیک کنید. این هشدار به این دلیل نمایش داده می‌شود که کلاینت OAuth شما تأیید نشده است. ادامه کار در طول توسعه بی‌خطر است.
     
     
   • محدوده‌های مورد نیاز را انتخاب کنید ( مشاهده، ویرایش و حذف ادغام‌های API گوگل پی ) و سپس برای اعطای دسترسی به آنتی‌گراویتی، روی ادامه کلیک کنید.
     
5. کد مجوز را کپی کنید و کد را در پنجره کد مجوز ارسال کنید.
   

سایر ابزارهای هوش مصنوعی

برای پیکربندی سایر ابزارهای هوش مصنوعی، به راهنمای پیکربندی برنامه هوش مصنوعی خود مراجعه کنید.

۴. ادغام‌های جدید گوگل پی را در پرداخت نهایی بگنجانید

توسعه نرم‌افزار سنتی اغلب نیازمند پیمایش مشخصات گسترده API، کپی کردن کدهای تکراری و تنظیم پارامترها است. در مقابل، با پیکربندی سرور Google Pay MCP در Antigravity، می‌توانید LLM خود را وادار کنید تا یک تجربه پرداخت آماده برای تولید را ایجاد کند.

1. درخواست Antigravity برای بستن حساب: یک جلسه چت فعال Antigravity (با فعال بودن سرور Google Pay MCP) باز کنید و درخواست بستن حساب زیر را صادر کنید:

   Act as a developer and integrate the Google Pay API into a checkout page using HTML, CSS, and vanilla JavaScript. 
   
   Please ensure the implementation follows these Google Pay best practices:
   1. *Check Readiness*: As the first step, call `isReadyToPay()`. Only render the Google Pay button if this method returns true.
   2. *Layout & Placement*: Set Google Pay as the default payment option. Position the Google Pay button at the very top of the payment list, above any credit card entry forms.
   3. *Button Styling*: Render a dynamic button by setting `buttonType` to `'buy'` or `'pay'` so it previews the user''s saved card. Ensure the button theme contrasts with the page background.
   4. *Payment Methods*: In `allowedAuthMethods`, specify both `'PAN_ONLY'` and `'CRYPTOGRAM_3DS'` so that Google Pay accepts both standard cards-on-file, and device tokens. 
   5. *Card Networks*: Add `'VISA'`, `'MASTERCARD'`, and `'AMEX'` to `allowedCardNetworks`.
   6. *Transaction Info*: Set the `checkoutOption` parameter to `'COMPLETE_IMMEDIATE_PURCHASE'` so Google Pay sheet displays a "Pay" button instead of "Continue".
   7. *3D-Secure Step-Up*: Treat Google Pay risk checks consistently with regular cards. If your standard checkout flow triggers a 3D-S step-up for normal cards, ensure risk-based 3D-S is triggered based on signals returned in the `loadPaymentData()` response.
   8. *Testing*: Serve and test the checkout page locally using a Python3 web server.
   

2. اجازه دهید LLM به ابزارهای MCP متصل شود: LLM با پرس‌وجوهایی مانند درخواست loadPaymentData search_documentation اجرا می‌کند. سرور Google Pay MCP از جاسازی‌های بردار RAG خود پرس‌وجو می‌کند و طرحواره JSON دقیقی را که Google Pay نیاز دارد، برمی‌گرداند.
3. مشاهده اجرا و تولید کد: Antigravity دستورات شما را با خروجی ابزارهای MCP ترکیب می‌کند تا یک طرح اولیه برای بررسی شما ایجاد کند و یا نظراتی را برای تنظیم اضافه کند یا آن را تأیید کند:
   
   تصویر زیر نسخه آزمایشی تولید شده را نشان می‌دهد. توجه داشته باشید که ظاهر و حس نسخه آزمایشی ممکن است بسته به زمینه Antigravity شما متفاوت باشد:
   
   

عیب‌یابی

اگر تجربه پرداخت ایجاد شده با انتظارات شما مطابقت ندارد، می‌توانید با Antigravity آن را تنظیم کنید. در اینجا چند مثال آورده شده است:

• تنظیم کنتراست و استایل دکمه: اگر دکمه با تم بصری سایت شما مطابقت ندارد، موارد زیر را انجام دهید:

  The page background is dark. Please update `createButton()` to use `buttonColor: 'white'` and adjust container margins so it sits cleanly above our credit card form.
  

• اعتبارسنجی شناسه‌های فروشنده: اگر نیاز به جابجایی بین پیکربندی‌های فروشنده TEST و PRODUCTION دارید، دستور زیر را اجرا کنید:

  Use `list_google_pay_integrations` to fetch our latest test or production merchant ID and explicitly inject it into `merchantInfo.merchantId`.
  

• بررسی سیگنال‌های افزایش اعتبار 3D-Secure: برای بررسی اینکه آیا اعتبارسنجی افزایش اعتبار 3D-Secure به درستی در برابر سیگنال‌های خطر دستگاه assuranceDetails ارزیابی می‌شود، دستور زیر را اجرا کنید:

  Please verify in `onGooglePaymentButtonClicked()` if 3D-Secure step-up logic is conditionally triggered based upon the `assuranceDetails` signal returned inside the `loadPaymentData()` response.
  

۵. بهینه‌سازی تجربه کاربری برای هزینه‌های اضافی پویا

گاهی اوقات، پذیرندگان و PSPها نیاز دارند که هزینه‌های اضافی، تخفیف‌ها یا قیمت‌گذاری پویا را بر اساس نوع کارت اصلی محاسبه کنند. به عنوان مثال، اعمال 0.1٪ هزینه اضافی برای کارت‌های نقدی/پیش‌پرداخت در مقابل 0.5٪ هزینه اضافی برای کارت‌های اعتباری. گوگل پی این سیگنال حیاتی را از طریق cardFundingSource ارائه می‌دهد.

درک تفاوت‌های ظریف cardFundingSource

قبل از اجرای قیمت‌گذاری پویا، درک چگونگی رفتار این سیگنال در محیط‌های مختلف ضروری است:

• محیط آزمایشی : توجه داشته باشید که برگه پرداخت گوگل پی در TEST همیشه قیمت کل را نمایش می‌دهد. فروشندگان باید سیگنال دریافتی از پاسخ را دریافت کرده و قیمت نهایی (شامل کارمزدهای اضافی) را قبل از تأیید پرداخت، همانطور که در این مثال نشان داده شده است، در صفحه تأیید سفارش خود نمایش دهند.
• استقرار تولید: اگر نیاز دارید که قیمت کل را در فیش حقوقی گوگل پی پنهان کنید، برای دریافت مجوز فهرست‌بندی با شناسه فروشنده (Merchant ID) با نماینده گوگل خود تماس بگیرید.

توسعه مبتنی بر مشخصات برای قیمت‌گذاری پویا

1. از ابزار MCP برای جستجوی مستندات توسعه‌دهنده استفاده کنید: در جلسه چت فعال Antigravity خود، LLM را با استفاده از SDD فعال کنید:

   Enhance the Google Pay integrations according to business specification: 
   - Use "sabre" as the gateway for the TEST environment.
   - Calculate a 0.1% extra fee for DEBIT and PREPAID cards, and a 0.5% extra fee for CREDIT cards. 
   - After the surcharge is calculated, update the checkout confirmation screen so the user reviews the final price before acquirer authorization.
   Use `search_documentation` to look up the technical specification for consuming `cardFundingSource` signal of Google Pay API. 
   

💡 نکته : پس از تغییر فایل‌های JS و CSS، به یاد داشته باشید که مرورگر خود را با استفاده از دستورات Ctrl+Shift+R یا Cmd+Shift+R مجدداً بارگذاری کنید تا مطمئن شوید که به‌روزرسانی‌ها در صفحه آزمایشی شما منعکس می‌شوند.

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

   /**
    * Calculates an extra fee based on the card funding source signal.
    * @param {object} paymentData - The payment data object from the API response.
    */
   function processPayment(paymentData) {
     // Access the card funding source from the nested API response info object
     const cardFundingSource = paymentData.paymentMethodData.info.cardFundingSource;
     let totalPrice = 10.00;
     let extraFee = 0;
   
     switch (cardFundingSource) {
       case 'DEBIT':
       case 'PREPAID':
         extraFee = totalPrice * 0.001; // Apply 0.1% fee
         break;
       case 'CREDIT':
       default:
         extraFee = totalPrice * 0.005; // Apply 0.5% fee
         break;
     }
   
     const finalOrderTotal = totalPrice + extraFee;
     console.log(`Card Type: ${cardFundingSource} | Fee: $${extraFee.toFixed(3)} | Final Total: $${finalOrderTotal.toFixed(2)}`);
   
     // Update your checkout confirmation screen so the user reviews the final price before acquirer authorization
     displayFinalConfirmationScreen(finalOrderTotal, extraFee);
   }
   

۶. [اختیاری] افزایش نرخ موفقیت پرداخت برای موارد تکراری

ℹ️ توجه : این بخش نحوه پیاده‌سازی تراکنش‌های آغاز شده توسط فروشنده (MIT) را برای مدل‌های اشتراک نشان می‌دهد. می‌توانید این تمرین اختیاری را اکنون یا بعداً در صورتی که ادغام شما نیاز به پرداخت‌های دوره‌ای دارد، انجام دهید.

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

به کارگیری توسعه مبتنی بر مشخصات

به جای اینکه به LLM اجازه دهید به طور گسترده در وب جستجو کند - که خطر استفاده از مشخصات فنی نادرست را به همراه دارد - شما به LLM خود دستور می‌دهید که از ابزار search_documentation سرور Google Pay MCP استفاده کند.

1. درخواست بازیابی مشخصات: در جلسه چت فعال Antigravity خود، LLM را مطلع کنید:

   Enhance the Google Pay integrations to support new recurring business requirement:
   - Update Google Pay integrations to support a monthly recurring subscription of $14.99.
   - Use `search_documentation` to look up the technical specification for `RecurringTransactionInfo` and MIT in Google Pay API. 
   

💡 نکته : پس از تغییر فایل‌های JS و CSS، به یاد داشته باشید که مرورگر خود را با استفاده از دستورات Ctrl+Shift+R یا Cmd+Shift+R مجدداً بارگذاری کنید تا مطمئن شوید که به‌روزرسانی‌ها در صفحه آزمایشی شما منعکس می‌شوند.

2. پیاده‌سازی کد بهبود یافته را بررسی کنید: به‌روزرسانی‌های LLM onGooglePaymentButtonClicked با پارامترهای MIT معتبر:

   function getGoogleRecurringTransactionInfo() {
     return {
       currencyCode: 'USD',
       countryCode: 'US',
       transactionId: 'sub-1499-monthly-' + Date.now(),
       tokenUpdateUrl: 'https://api.acmestore.com/token/update',
       managementUrl: 'https://acmestore.com/account/subscriptions',
       billingAgreement: 'Monthly recurring subscription of $14.99 for Acme Pro. Cancel anytime in your account settings.',
       immediateTotalPrice: '14.99',
       recurrenceItems: [
         {
           label: "Acme Pro Monthly Subscription",
           price: "14.99",
           priceStatus: "FINAL",
           recurrencePeriod: "MONTH",
           recurrencePeriodCount: 1
         }
       ]
     };
   }
   

   برای اطمینان از نمایش جزئیات اشتراک دوره‌ای اختصاصی در برگه پرداخت گوگل پی، صفحه آزمایشی را مشاهده کنید:

عیب‌یابی

اگر با خطا مواجه شدید:

Payment failed to initialize: Exactly one of transactionInfo, automaticReloadTransactionInfo, deferredTransactionInfo, or recurringTransactionInfo must be set!

می‌توانید خطا را در جلسه چت فعال Antigravity خود کپی کنید تا با استفاده از ابزار MCP search_documentation خطا به طور خودکار برطرف شود.

۷. [اختیاری] تبدیل‌ها را با نظارت عاملی بلندمدت محافظت کنید

ℹ️ توجه : این بخش نحوه استفاده از عامل Antigravity را برای نظارت مداوم بر ادغام Google Pay شما نشان می‌دهد. می‌توانید این تمرین اختیاری را اکنون یا بعداً در صورت نیاز به نظارت عامل‌دار، انجام دهید.

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

به جای نظارت دستی بر مشکلات پرداخت، می‌توانید نظارت مداوم و بهینه‌سازی تبدیل را به یک عامل (agent) واگذار کنید. در این تمرین، ما بررسی می‌کنیم که چگونه نظارت و بهینه‌سازی تبدیل را به عنوان یک مهارت عامل ضد جاذبه (Antigravity Agent Skill ) تعریف کنیم و آن را به صورت خودکار به عنوان یک وظیفه بلندمدت (Long-Horizon Task) اجرا کنیم.

مهارت عامل ضد جاذبه را ایجاد کنید و به عنوان یک وظیفه بلندمدت اجرا کنید

1. مهارت نظارت و اصلاح ( SKILL.md ) را تعریف کنید: یک کتابچه راهنمای مهارت ساختارمند با نام ~/.agents/skills/gpay-monitor-fix/SKILL.md (یا ~/.gemini/skills/gpay-monitor-fix/SKILL.md ) در ریشه فضای کاری خود ایجاد کنید. YOUR_MERCHANT_ID را با شناسه فروشنده خود از کنسول Google Pay جایگزین کنید:

   ---
   name: gpay-monitor-fix
   description: Autonomously queries Google Pay merchant error metrics over long-horizon windows, root-causes checkout failures against official API specs, generates remediation patches, and proposes payment conversion optimization plans.
   ---
   
   # Google Pay Long-Horizon Monitoring & Conversion Optimization Skill
   When invoked for long-horizon monitoring and conversion optimization, execute the following autonomous loop:
   1.  **Analyze production traffic:** Call the Google Pay MCP tool `query_merchant_error_metrics` targeting merchant ID YOUR_MERCHANT_ID for Time Range of TIME_RANGE_PAST_WEEK..
   2.  **Evaluate error and drop-offs:** Check the returned metrics for error spikes (e.g., user cancellation errors, or `OR_BIBED_06` failures) that directly degrade conversion rates.
   3.  **Perform diagnosis:** If an error anomaly or conversion bottleneck is detected, extract the failed request structure and query the `search_documentation` MCP tool with the exact error code or payload discrepancy based on Google Pay API specifications.
   4.  **Synthesize automated optimization plan:** Correlate the failing payload against official RAG-retrieved schemas to identify root causes (e.g., incorrect `tokenizationSpecification` or missing mandatory MIT fields). Formulate a proactive optimization plan to streamline user checkout steps.
   5.  **Generate onversion fix:** Create a code branch, apply the exact code fix to our checkout implementation (e.g., `checkout.js` or `main.js`), and open a Pull Request detailing the anomaly, root-cause diagnosis and verified code patch.
   

2. زمان‌بندی وظیفه پس‌زمینه با افق طولانی در Antigravity: پس از تعریف مهارت خود، در یک جلسه فعال Antigravity، دستور /schedule را برای پیکربندی یک عامل Antigravity وارد کنید:

   /schedule
   "Everyday at midnight, invoke @gpay-monitor-fix skill to check our checkout error metrics and conversion performance. If any anomaly spike is detected, diagnose the root cause, generate a fix pull request, and propose conversion optimization plans by morning."
   

   
   شما می‌توانید دستور /schedule را بدون هیچ آرگومانی دوباره وارد کنید تا وضعیت وظایف زمان‌بندی‌شده‌ی فعال خود را بررسی کنید.
   
   از طرف دیگر، برای اجرای یک عامل نظارت و بهینه‌سازی برای مدت نامحدود، می‌توانید اجرای هدفمند Antigravity را فعال کنید:

   /goal
   Invoke @gpay-monitor-fix to continuously monitor checkout traffic, investigate errors and propose optimizations. Do not mark this goal complete (<!-- GOAL_COMPLETE -->); continue monitoring and auditing indefinitely.
   

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

۸. [اختیاری] بهبود نرخ تبدیل با پرداخت مهمان GPay express

ℹ️ توجه : این بخش نحوه پیاده‌سازی پرداخت سریع مهمان را مستقیماً در صفحه جزئیات محصول برای کاهش اصطکاک قیف تبدیل نشان می‌دهد. می‌توانید این تمرین اختیاری را اکنون یا بعداً انجام دهید.

جریان‌های پرداخت چند مرحله‌ای سنتی اغلب کاربران را ملزم به وارد کردن دستی اطلاعات طولانی حمل و نقل و صورتحساب یا حتی ایجاد حساب کاربری می‌کنند که باعث ایجاد اصطکاک و در نهایت منجر به ترک مشتری در قیف تبدیل می‌شود. با پیاده‌سازی پرداخت سریع مهمان به طور مستقیم در صفحه جزئیات محصول با Google Pay، به کاربران این امکان را می‌دهید که با حداقل کلیک، پرداخت را انجام دهند و با دریافت ایمن اطلاعات از پیش ذخیره شده از حساب‌های Google خود، ورود دستی فرم را از بین ببرند.

توسعه مبتنی بر مشخصات برای پرداخت مهمان

1. درخواست بازیابی مشخصات و اجرای پرداخت مهمان: در جلسه چت فعال Antigravity خود، LLM را درخواست کنید:

   Implement Google Pay for express guest checkout directly on the product details page. Ensure users select product attributes before clicking Google Pay (or checkout button).
   
   To minimize clicks and eliminate manual entry, collect the following via the Google Pay API:
   - Email address
   - Shipping address (with phone number)
   - Billing address inside card parameters
   
   Use search_documentation for API specs.
   

💡 نکته : پس از تغییر فایل‌های JS و CSS، به یاد داشته باشید که مرورگر خود را با استفاده از دستورات Ctrl+Shift+R یا Cmd+Shift+R به صورت کامل بارگذاری مجدد کنید تا مطمئن شوید که به‌روزرسانی‌ها در صفحه آزمایشی شما منعکس می‌شوند.

2. بررسی پیاده‌سازی کد بهبود یافته: LLM درخواست داده‌های پرداخت را به‌روزرسانی می‌کند تا جزئیات ارسال، تماس و صورتحساب را مستقیماً از طریق API گوگل پی جمع‌آوری کند:

   function getGooglePaymentDataRequest() {
     const paymentDataRequest = Object.assign({}, baseRequest);
     paymentDataRequest.allowedPaymentMethods = [cardPaymentMethod];
     paymentDataRequest.transactionInfo = getGoogleTransactionInfo();
     paymentDataRequest.merchantInfo = getGoogleMerchantInfo();
   
     // Collect email address and shipping address (with phone number) for guest checkout
     paymentDataRequest.emailRequired = true;
     paymentDataRequest.shippingAddressRequired = true;
     paymentDataRequest.shippingAddressParameters = {
       phoneNumberRequired: true
     };
   
     return paymentDataRequest;
   }
   

   و درون cardPaymentMethod ، پارامترهای آدرس صورتحساب پیکربندی شده‌اند:

   const cardPaymentMethod = Object.assign({}, baseCardPaymentMethod, {
     tokenizationSpecification: tokenizationSpecification,
     billingAddressRequired: true,
     billingAddressParameters: {
       format: 'FULL',
       phoneNumberRequired: true
     }
   });
   

3. پرداخت سریع مهمان را آزمایش کنید: صفحه آزمایشی را مشاهده کنید تا مطمئن شوید که دکمه پرداخت مهمان که مستقیماً در صفحه جزئیات محصول قرار دارد، تمام ویژگی‌های مورد نیاز را جمع‌آوری می‌کند و ورود دستی را حذف می‌کند:
   
   

۹. تمیز کردن

حذف پروژه گوگل کلود

⚠️ هشدار : حذف این پروژه گوگل کلود، تمام منابع درون آن، از جمله هر کاری که به این آزمایشگاه کد مربوط نباشد را برای همیشه از بین می‌برد. علاوه بر این، شما قادر به استفاده مجدد از این شناسه پروژه سفارشی در آینده نخواهید بود. برای حفظ شناسه، فقط منابع خاص ایجاد شده در طول این آزمایشگاه را حذف کنید، نه کل پروژه را.

برای جلوگیری از تحمیل هزینه به حساب گوگل کلود شما برای منابع استفاده شده در این آزمایشگاه کد، توصیه می‌کنیم پروژه گوگل کلود را حذف کنید.

gcloud projects delete $GOOGLE_CLOUD_PROJECT

۱۰. نتیجه‌گیری

شما صفحه پرداخت با کد Vibe از طریق Google Pay API: را با سرورهای MCP و کارگاه Antigravity تکمیل کرده‌اید!

شما یاد گرفته‌اید که چگونه سرور Google Pay MCP را به یک ابزار بومی هوش مصنوعی متصل کنید، با استفاده از مهندسی متن، یکپارچه‌سازی‌های تمیز پرداخت را ایجاد کنید، گردش‌های کاری اشتراک و قیمت‌گذاری پویا را با استفاده از توسعه مبتنی بر Spec-Driven پیاده‌سازی کنید و خطوط لوله نظارتی مستقل مبتنی بر LLM را مستقر کنید. اکنون شما مجهز به کدنویسی Vibe-code برای کاربر پرداخت با قابلیت اطمینان در آینده و گردش‌های کاری نظارتی مبتنی بر هوش مصنوعی هستید.

منابع اضافی

• به کانال #google-dev-community در دیسکورد بپیوندید
• @GooglePayDevs را در X دنبال کنید