پیکربندی کنترل‌کننده پرداخت گوگل پی

این مرجع بر اساس طرحواره شیء پیکربندی برای کنترل‌کننده پرداخت Google Pay برای پروتکل تجارت جهانی (UCP) است.

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

خواص

ملک نوع ضرورت توضیحات
api_version عدد صحیح مورد نیاز نسخه اصلی API گوگل پی. فقط 2 پشتیبانی می‌شود.
api_version_minor عدد صحیح مورد نیاز نسخه فرعی API گوگل پی. فقط 0 نسخه پشتیبانی می‌شود.
environment رشته مورد نیاز محیط Google Pay برای استفاده.
  • TEST : اعتبارنامه‌های پرداخت فقط برای تست.
  • PRODUCTION : اعتبارنامه‌های پرداخت واقعی و مجاز.
merchant_info شیء مورد نیاز جزئیات هویتی تاجر.
merchant_info. merchant_id رشته مورد نیاز شناسه فروشنده گوگل پی شما از کنسول گوگل پی و کیف پول . این برای محیط PRODUCTION الزامی است. این اختیاری است و در محیط TEST نادیده گرفته می‌شود.
merchant_info. merchant_name رشته اختیاری نام تجاریِ کاربر-محورِ تاجر.
merchant_info. merchant_origin رشته اختیاری دامنه وب کاملاً واجد شرایط که پرداخت در آن انجام می‌شود (فرمت: hostname ).
merchant_info. auth_jwt رشته اختیاری مجوزدهی JWT برای زمینه‌های یکپارچه‌سازی خاص.
allowed_payment_methods شیء[] مورد نیاز روش‌های پرداخت مجاز برای این تراکنش.
allowed_payment_methods[]. type رشته مورد نیاز نوع روش پرداخت پشتیبانی شده. فقط CARD پشتیبانی می‌شود.
allowed_payment_methods[]. parameters شیء مورد نیاز پارامترهای مورد نیاز برای پیکربندی روش پرداخت CARD .
allowed_payment_methods[].parameters. allowed_auth_methods رشته[] مورد نیاز فیلدهای پشتیبانی‌شده برای تأیید اعتبار تراکنش کارت.
  • PAN_ONLY : شماره حساب اصلی (PAN) و تاریخ انقضای کارت موجود در پرونده Google Wallet را برمی‌گرداند.
allowed_payment_methods[].parameters. allowed_card_networks رشته[] مورد نیاز شبکه‌های کارت پشتیبانی‌شده توسط فروشنده. مقادیر پشتیبانی‌شده: AMEX ، DISCOVER ، ELECTRON ، ELO ، ELO_DEBIT ، INTERAC ، JCB ، MAESTRO ، MASTERCARD ، VISA .
allowed_payment_methods[].parameters. allow_prepaid_cards بولی اختیاری اگر از کارت‌های پیش‌پرداخت پشتیبانی نمی‌کنید، روی false تنظیم کنید. پیش‌فرض true است.
allowed_payment_methods[].parameters. allow_credit_cards بولی اختیاری اگر از کارت‌های اعتباری پشتیبانی نمی‌کنید، روی false تنظیم کنید. پیش‌فرض true است.
allowed_payment_methods[].parameters. assurance_details_required بولی اختیاری برای درخواست جزئیات تضمین کارت، روی true تنظیم کنید.
allowed_payment_methods[].parameters. billing_address_required بولی اختیاری اگر برای تکمیل تراکنش به آدرس صورتحساب نیاز دارید، روی true تنظیم کنید.
allowed_payment_methods[].parameters. billing_address_parameters شیء اختیاری پارامترهایی که آدرس صورتحساب برگشتی را پیکربندی می‌کنند.
allowed_payment_methods[].parameters.billing_address_parameters. format رشته اختیاری قالب آدرس صورتحساب برای تکمیل تراکنش الزامی است.
  • MIN : نام، کد کشور و کد پستی (پیش‌فرض).
  • FULL : نام، آدرس خیابان، محل سکونت، منطقه، کد کشور و کد پستی.
  • FULL-ISO3166 : نام، آدرس خیابان، محل، منطقه، کد کشور، کد پستی و iso3166AdministrativeArea .
allowed_payment_methods[].parameters.billing_address_parameters. phone_number_required بولی اختیاری اگر برای تکمیل تراکنش به شماره تلفن نیاز دارید، روی true تنظیم کنید.
allowed_payment_methods[]. tokenization_specification شیء مورد نیاز پیکربندی که نحوه‌ی بازگرداندن اطلاعات پرداخت به شما را تعریف می‌کند.
allowed_payment_methods[].tokenization_specification. type رشته مورد نیاز نوع توکن‌سازی.
  • PAYMENT_GATEWAY : اگر پرداخت‌ها را از طریق [درگاه پشتیبانی‌شده](/pay/api#participating-processors) پردازش می‌کنید، استفاده می‌شود. یک payload رمزگذاری‌شده را برای ارسال به PSP شما برمی‌گرداند.
  • DIRECT : در صورتی استفاده می‌شود که خودتان اعتبارنامه‌ها را رمزگشایی کنید (نیاز به انطباق با PCI DSS سطح 1 دارد).
allowed_payment_methods[].tokenization_specification. parameters شیء مورد نیاز پارامترهای مختص type توکن‌سازی انتخاب‌شده.

برای PAYMENT_GATEWAY ، پارامترهای مورد نیاز عبارتند از: برای DIRECT ، پارامترهای مورد نیاز عبارتند از:
  • protocolVersion : نسخه پروتکل رمزگذاری و امضای مورد انتظار در اعتبارنامه Google Pay. فقط ECv2 پشتیبانی می‌شود. برای اطلاعات بیشتر به رمزنگاری داده‌های پرداخت مراجعه کنید.
  • publicKey : کلید عمومی منحنی بیضوی کدگذاری شده با Base64. برای اطلاعات بیشتر به بخش قالب کلید عمومی رمزگذاری مراجعه کنید.