Konfigurasi pemroses pembayaran Google Pay

Referensi ini didasarkan pada skema objek konfigurasi untuk pengendali pembayaran Google Pay untuk Universal Commerce Protocol (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": {
          ...
        }
      }
    }
  ]
}

Properti

Properti Jenis Kebutuhan Deskripsi
api_version bilangan bulat Wajib Versi utama Google Pay API. Hanya 2 yang didukung.
api_version_minor bilangan bulat Wajib Versi minor Google Pay API. Hanya 0 yang didukung.
environment string Wajib Lingkungan Google Pay yang akan digunakan.
  • TEST: Kredensial pembayaran khusus pengujian.
  • PRODUCTION: Kredensial pembayaran yang sebenarnya dan dapat diotorisasi.
merchant_info objek Wajib Detail identitas untuk penjual.
merchant_info.merchant_id string Wajib ID penjual Google Pay Anda dari Konsol Google Pay & Wallet. ID ini wajib diisi untuk lingkungan PRODUCTION. ID ini bersifat opsional dan diabaikan di lingkungan TEST.
merchant_info.merchant_name string Opsional Nama bisnis penjual yang ditampilkan kepada pengguna.
merchant_info.merchant_origin string Opsional Domain web yang sepenuhnya memenuhi syarat tempat checkout terjadi (format: hostname).
merchant_info.auth_jwt string Opsional JWT otorisasi untuk konteks integrasi tertentu.
allowed_payment_methods objek[ ] Wajib Metode pembayaran yang diizinkan untuk transaksi ini.
allowed_payment_methods[].type string Wajib Jenis metode pembayaran yang didukung. Hanya CARD yang didukung.
allowed_payment_methods[].parameters objek Wajib Parameter yang diperlukan untuk mengonfigurasi metode pembayaran CARD.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] Wajib Kolom yang didukung untuk mengautentikasi transaksi kartu.
  • PAN_ONLY: Menampilkan nomor rekening utama (PAN) dan tanggal habis masa berlaku untuk kartu yang tersimpan di Google Wallet.
allowed_payment_methods[].parameters.allowed_card_networks string[ ] Wajib Jaringan kartu yang didukung oleh penjual. Nilai yang didukung: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards boolean Opsional Tetapkan ke false jika Anda tidak mendukung kartu prabayar. Default-nya adalah true.
allowed_payment_methods[].parameters.allow_credit_cards boolean Opsional Tetapkan ke false jika Anda tidak mendukung kartu kredit. Default-nya adalah true.
allowed_payment_methods[].parameters.assurance_details_required boolean Opsional Tetapkan ke true untuk meminta detail jaminan kartu.
allowed_payment_methods[].parameters.billing_address_required boolean Opsional Tetapkan ke true jika Anda memerlukan alamat penagihan untuk menyelesaikan transaksi.
allowed_payment_methods[].parameters.billing_address_parameters objek Opsional Parameter yang mengonfigurasi alamat penagihan yang ditampilkan.
allowed_payment_methods[].parameters.billing_address_parameters.format string Opsional Format alamat penagihan yang diperlukan untuk menyelesaikan transaksi.
  • MIN: Nama, kode negara, dan kode pos (default).
  • FULL: Nama, alamat jalan, lokalitas, wilayah, kode negara, dan kode pos.
  • FULL-ISO3166: Nama, alamat jalan, lokalitas, wilayah, kode negara, kode pos, dan iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required boolean Opsional Tetapkan ke true jika Anda memerlukan nomor telepon untuk menyelesaikan transaksi.
allowed_payment_methods[].tokenization_specification objek Wajib Konfigurasi yang menentukan cara kredensial pembayaran ditampilkan kepada Anda.
allowed_payment_methods[].tokenization_specification.type string Wajib Jenis tokenisasi.
  • PAYMENT_GATEWAY: Digunakan jika Anda memproses pembayaran melalui [gateway yang didukung](/pay/api#participating-processors). Menampilkan payload terenkripsi yang akan diteruskan ke PSP Anda.
  • DIRECT: Digunakan jika Anda mendekripsi kredensial sendiri (memerlukan kepatuhan PCI DSS Level 1).
allowed_payment_methods[].tokenization_specification.parameters objek Wajib Parameter khusus untuk type tokenisasi yang dipilih.

Untuk PAYMENT_GATEWAY, parameter wajib adalah: Untuk DIRECT, parameter wajib adalah:
  • protocolVersion: Versi protokol enkripsi dan tanda tangan yang diharapkan dalam kredensial Google Pay. Hanya ECv2 yang didukung. Lihat Kriptografi data pembayaran untuk mengetahui informasi selengkapnya.
  • publicKey: Kunci publik kurva eliptik berenkode Base64. Lihat bagian Format kunci publik enkripsi untuk mengetahui informasi selengkapnya.