پیکربندی مدیریت‌كننده پرداخت Google Pay

این مرجع براساس طرحواره شیء پیکربندی برای مدیر پرداخت 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,
        "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 عدد صحیح الزامی نسخه اصلی «میانای برنامه‌سازی کاربردی Google Pay». فقط از 2 پشتیبانی می‌شود.
api_version_minor عدد صحیح الزامی نسخه فرعی «میانای برنامه‌سازی کاربردی Google Pay». فقط از 0 پشتیبانی می‌شود.
environment رشته الزامی محیط Google Pay برای استفاده.
  • ‫TEST: اطلاعات کاربری پرداخت فقط برای آزمایش.
  • ‫PRODUCTION: اطلاعات اعتباری پرداخت واقعی و قابل‌تأیید.
merchant_info شیء الزامی جزئیات هویت فروشنده.
merchant_info.merchant_id رشته الزامی شناسه فروشنده Google Pay شما از کنسول کیف پول و Google Pay. این برای محیط PRODUCTION الزامی است. اختیاری است و در محیط TEST نادیده گرفته می‌شود. شناسه فروشنده شما مقداری عددی یا الفبایی-عددی است که در کنار نام کسب‌وکارتان در «کنسول کیف پول و Google Pay» نمایش داده می‌شود.
merchant_info.merchant_name رشته اختیاری نام کسب‌وکار فروشنده که برای کاربر نمایش داده می‌شود.
merchant_info.merchant_origin رشته اختیاری دامنه وب کاملاً واجدشرایطی که تسویه‌حساب در آن انجام می‌شود (قالب: hostname).
merchant_info.auth_jwt رشته اختیاری JWT مجوز برای برخی زمینه‌های ادغام.
allowed_payment_methods شیء[ ] الزامی روش‌های پرداخت مجاز برای این تراکنش.
allowed_payment_methods[].type رشته الزامی نوع روش پرداخت پشتیبانی‌شده. مقادیر پشتیبانی‌شده: CARD، EWALLET.
allowed_payment_methods[].parameters شیء اختیاری پارامترهای لازم برای پیکربندی روش پرداخت CARD. اگر type برابر با CARD باشد، این دارایی الزامی است.
allowed_payment_methods[].parameters.allowed_auth_methods رشته[ ] الزامی فیلدهای پشتیبانی‌شده برای اصالت‌سنجی تراکنش کارت.
  • PAN_ONLY: شماره حساب اصلی (PAN) و تاریخ انقضای کارت ثبت‌شده در «کیف پول Google» را برمی‌گرداند.
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.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 شیء اختیاری پیکربندی که نحوه برگرداندن اطلاعات اعتباری پرداخت به شما را تعریف می‌کند. اگر type CARD باشد، این ویژگی الزامی است.
allowed_payment_methods[].tokenization_specification.type رشته الزامی نوع نشانه‌گذاری.
  • PAYMENT_GATEWAY: اگر پرداخت‌ها را ازطریق [درگاه پشتیبانی‌شده](/pay/api#participating-processors) پردازش می‌کنید، از این مورد استفاده می‌شود. یک محتوای رمزگذاری‌شده را برمی‌گرداند تا به PSP شما ارسال شود.
  • ‫DIRECT: اگر خودتان اعتبارنامه‌ها را رمزگشایی می‌کنید، از این گزینه استفاده می‌شود (رعایت استاندارد امنیت داده‌های صنعت کارت پرداخت سطح ۱ الزامی است).
allowed_payment_methods[].tokenization_specification.parameters شیء الزامی پارامترهای مختص به رمزسازی انتخابی type.

برای PAYMENT_GATEWAY، پارامترهای الزامی عبارت‌اند از: برای DIRECT، پارامترهای الزامی عبارتند از:
  • protocolVersion: نسخه پروتکل رمزگذاری و امضا که در اطلاعات کاربری Google Pay انتظار می‌رود. فقط از ECv2 پشتیبانی می‌شود. برای اطلاعات بیشتر، رمزنگاری داده‌های پرداخت را ببینید.
  • ‫publicKey: کلید عمومی منحنی بیضوی کدگذاری‌شده با Base64. برای اطلاعات بیشتر، به بخش قالب کلید عمومی رمزگذاری مراجعه کنید.
allowed_payment_methods[].processing_specification شیء اختیاری اطلاعات لازم برای پردازش پرداخت را تعریف کنید. اگر type EWALLET باشد، این ویژگی الزامی است.
allowed_payment_methods[].processing_specification.type رشته الزامی نوع ارائه‌دهنده کیف پول الکترونیکی. مقادیر پشتیبانی‌شده: SHOPEE_PAY، TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters شیء الزامی پارامترهای مختص ارائه‌دهنده کیف پول الکترونیکی انتخاب‌شده.

پارامترهای الزامی عبارت‌اند از:
  • ‫ewallet_merchant_name: نام نمایشی فروشنده که برای کاربر نمایش داده می‌شود.
  • ‫ewallet_merchant_account: شناسه فروشنده صادرشده توسط تجمیع‌گر یا کیف پول الکترونیکی.
  • ‫psp_transaction_reference: شماره مرجع یکتایی که PSP برای یک‌سان‌بودن تولید می‌کند.