Google Pay ödeme işleyici yapılandırması

Bu referans, Evrensel Ticaret Protokolü (UCP) için Google Pay ödeme işleyicinin config nesnesi şemasına dayanmaktadır.

{
  "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": {
          ...
        }
      }
    }
  ]
}

Özellikler

Mülk Tür Gereklilik Açıklama
api_version tam sayı Zorunlu Google Pay API'sinin ana sürümü. Yalnızca 2 desteklenir.
api_version_minor tam sayı Zorunlu Google Pay API'sinin küçük sürümü. Yalnızca 0 desteklenir.
environment dize Zorunlu Kullanılacak Google Pay ortamı.
  • TEST: Yalnızca test amaçlı ödeme kimlik bilgileri.
  • PRODUCTION: Gerçek, yetkilendirilebilir ödeme kimlik bilgileri.
merchant_info nesne Zorunlu Satıcıyla ilgili kimlik bilgileri.
merchant_info.merchant_id dize Zorunlu Google Pay ve Cüzdan Konsolu'ndaki Google Pay satıcı kimliğiniz. Bu, PRODUCTION ortamı için gereklidir. İsteğe bağlıdır ve TEST ortamında yoksayılır.
merchant_info.merchant_name dize İsteğe bağlı Satıcının kullanıcıya gösterilen işletme adı.
merchant_info.merchant_origin dize İsteğe bağlı Ödemenin gerçekleştiği tam nitelikli web alanı (biçim: hostname).
merchant_info.auth_jwt dize İsteğe bağlı Belirli entegrasyon bağlamları için yetkilendirme JWT'si.
allowed_payment_methods object[ ] Zorunlu Bu işlem için izin verilen ödeme yöntemleri.
allowed_payment_methods[].type dize Zorunlu Desteklenen ödeme yönteminin türü. Yalnızca CARD desteklenir.
allowed_payment_methods[].parameters nesne Zorunlu CARD ödeme yöntemini yapılandırmak için gereken parametreler.
allowed_payment_methods[].parameters.allowed_auth_methods dize[ ] Zorunlu Kart işleminin kimliğini doğrulamak için desteklenen alanlar.
  • PAN_ONLY: Google Cüzdan'da kayıtlı bir kartın birincil hesap numarasını (PAN) ve son kullanma tarihini döndürür.
allowed_payment_methods[].parameters.allowed_card_networks dize[ ] Zorunlu Satıcı tarafından desteklenen kart ağları. Desteklenen değerler: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards boole İsteğe bağlı Ön ödemeli kartları desteklemiyorsanız false olarak ayarlayın. Varsayılan değer true'dır.
allowed_payment_methods[].parameters.allow_credit_cards boole İsteğe bağlı Kredi kartlarını desteklemiyorsanız false olarak ayarlayın. Varsayılan değer true'dır.
allowed_payment_methods[].parameters.assurance_details_required boole İsteğe bağlı Kart güvencesi ayrıntılarını istemek için true olarak ayarlayın.
allowed_payment_methods[].parameters.billing_address_required boole İsteğe bağlı İşlemi tamamlamak için fatura adresi gerekiyorsa true olarak ayarlayın.
allowed_payment_methods[].parameters.billing_address_parameters nesne İsteğe bağlı Döndürülen fatura adresini yapılandıran parametreler.
allowed_payment_methods[].parameters.billing_address_parameters.format dize İsteğe bağlı İşlemi tamamlamak için fatura adresi biçimi gereklidir.
  • MIN: Ad, ülke kodu ve posta kodu (varsayılan).
  • FULL: Ad, açık adres, yerleşim yeri, bölge, ülke kodu ve posta kodu.
  • FULL-ISO3166: Ad, açık adres, yerleşim yeri, bölge, ülke kodu, posta kodu ve iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required boole İsteğe bağlı İşlemi tamamlamak için telefon numarası gerekiyorsa true olarak ayarlayın.
allowed_payment_methods[].tokenization_specification nesne Zorunlu Ödeme kimlik bilgilerinin size nasıl döndürüleceğini tanımlayan yapılandırma.
allowed_payment_methods[].tokenization_specification.type dize Zorunlu Tokenleştirme türü.
  • PAYMENT_GATEWAY: Ödemeleri [desteklenen bir ağ geçidi](/pay/api#participating-processors) üzerinden işliyorsanız kullanılır. Ödeme hizmeti sağlayıcınıza iletilecek şifrelenmiş bir yük döndürür.
  • DIRECT: Kimlik bilgilerini kendiniz şifre çözerseniz kullanılır (PCI DSS Düzey 1 uygunluğu gerekir).
allowed_payment_methods[].tokenization_specification.parameters nesne Zorunlu Seçilen jetonlaştırmaya type özgü parametreler.

PAYMENT_GATEWAY için gerekli parametreler: DIRECT için gerekli parametreler şunlardır:
  • protocolVersion: Google Pay kimlik bilgisinde beklenen şifreleme ve imza protokolünün sürümü. Yalnızca ECv2 desteklenir. Daha fazla bilgi için Ödeme verisi kriptografisi başlıklı makaleyi inceleyin.
  • publicKey: Base64 kodlu eliptik eğri ortak anahtarı. Daha fazla bilgi için Şifreleme ortak anahtar biçimi bölümüne bakın.