Objek respons JSON

Referensi ini menjelaskan opsi objek respons Google Pay API yang akan digunakan dengan aplikasi Anda. Objek respons adalah objek yang ditampilkan oleh metode klien Google Pay API.

PaymentData

Ini adalah objek respons yang ditampilkan oleh Google setelah pembayar menyetujui pembayaran.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Properti Jenis Selalu ada Deskripsi
apiVersion number Ya Versi API utama. Nilai dalam respons cocok dengan nilai yang diberikan di
apiVersionMinor number Ya Versi API minor. Nilai dalam respons cocok dengan nilai yang diberikan di
paymentMethodData PaymentMethodData Ya Data tentang metode pembayaran yang dipilih.
email string Tidak Alamat email, jika emailRequired disetel ke true di PaymentDataRequest. Jika permintaan lain telah menyetel properti ke true, tidak ada efeknya.
shippingAddress Alamat Tidak Alamat pengiriman, jika shippingAddressRequired disetel ke true di

Contoh

Contoh respons untuk Google Pay API versi 2.0 ini menunjukkan metode pembayaran CARD yang dipilih di lembar pembayaran Google Pay. Token metode pembayaran dibuat untuk gateway example.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

Objek ini menyediakan data untuk metode pembayaran yang dipilih.

Properti Jenis Selalu ada Deskripsi
type string Ya PaymentMethod type yang dipilih di halaman pembayaran Google Pay.
description string Ya

Pesan yang ditampilkan kepada pengguna untuk mendeskripsikan metode pembayaran yang mendanai transaksi ini.
info objek Ya Nilai properti ini bergantung pada metode pembayaran type yang ditampilkan. Untuk CARD, lihat CardInfo.
tokenizationData PaymentMethodTokenizationData Tidak Data tokenisasi pembayaran untuk metode pembayaran yang dipilih.

Contoh

Contoh respons ini menunjukkan cara metode pembayaran CARD yang dipilih di halaman pembayaran Google Pay menghasilkan token metode pembayaran untuk gateway example.

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

Objek ini memberikan informasi tentang kartu pembayaran yang dipilih.

Properti Jenis Selalu ada Deskripsi
cardDetails string Ya Detail tentang kartu. Nilai ini biasanya adalah empat digit terakhir nomor akun pembayaran yang dipilih.
assuranceDetails AssuranceDetailsSpecifications Ya Objek ini memberikan informasi tentang validasi yang dilakukan pada data pembayaran yang ditampilkan jika assuranceDetailsRequired disetel ke true di CardParameters.
cardNetwork string Ya

Jaringan kartu pembayaran dari pembayaran yang dipilih. Nilai yang ditampilkan cocok dengan format allowedCardNetworks di CardParameters.

Nilai jaringan kartu ini tidak boleh ditampilkan kepada pembeli. Digunakan saat detail kartu pembeli diperlukan. Misalnya, jika dukungan pelanggan memerlukan nilai ini untuk mengidentifikasi kartu yang digunakan pembeli untuk transaksinya. Untuk deskripsi yang dapat dilihat pengguna, gunakan properti description dari PaymentMethodData sebagai gantinya.
billingAddress Alamat Tidak Alamat penagihan yang terkait dengan metode pembayaran yang diberikan, jika billingAddressRequired disetel ke true di CardParameters.
cardFundingSource string Ya

Sumber pendanaan kartu untuk metode pembayaran yang dipilih.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Contoh

Contoh ini menampilkan kartu di jaringan Visa.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

AssuranceDetailsSpecifications

Objek ini memberikan informasi tentang validasi yang telah dilakukan pada kredensial pembayaran yang ditampilkan sehingga pemeriksaan risiko instrumen yang sesuai dapat diterapkan.

Nama Jenis Deskripsi
accountVerified boolean Jika true, menunjukkan bahwa validasi kepemilikan Cardholder telah dilakukan pada kredensial pembayaran yang ditampilkan.
cardHolderAuthenticated boolean

Jika true, menunjukkan bahwa identifikasi dan verifikasi (ID&V) telah dilakukan pada kredensial pembayaran yang ditampilkan.

Jika false, autentikasi berbasis risiko yang sama dapat dilakukan seperti yang akan Anda lakukan untuk transaksi kartu. Autentikasi berbasis risiko ini dapat mencakup, tetapi tidak terbatas pada, peningkatan dengan protokol 3D Secure jika berlaku.

Anda dapat menerima dan memproses Objek respons meskipun Anda tidak menggunakan kolom assuranceDetails. Untuk menerima objek ini, sertakan assuranceDetailsRequired: true di CardParameters.

PaymentMethodTokenizationData

Objek ini menyediakan data tokenisasi untuk metode pembayaran.

Properti Jenis Selalu ada Deskripsi
type string Ya Jenis tokenisasi yang akan diterapkan ke metode pembayaran yang dipilih. Nilai ini cocok dengan type yang ditetapkan di PaymentMethodTokenizationSpecification.
token string Tidak

Token metode pembayaran yang dihasilkan.

Contoh

Berikut adalah contoh respons yang di-token dan disiapkan untuk gateway example.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

Alamat

Objek ini memberikan informasi tentang alamat pos yang diminta. Semua properti adalah string.

Alamat dapat ditampilkan dalam format MIN,FULL, dan FULL-ISO3166. Properti yang termasuk dalam setiap format dapat dilihat dalam tabel berikut.

Properti Format alamat Deskripsi
name MIN, FULL, FULL-ISO3166 Nama lengkap penerima surat.
postalCode MIN, FULL, FULL-ISO3166 Kode pos.
countryCode MIN, FULL, FULL-ISO3166 Kode negara ISO 3166-1 alpha-2.
phoneNumber MIN, FULL, FULL-ISO3166 Nomor telepon, jika phoneNumberRequired ditetapkan ke true di PaymentDataRequest.
address1 FULL, FULL-ISO3166 Baris pertama alamat.
address2 FULL, FULL-ISO3166 Baris kedua alamat.
address3 FULL, FULL-ISO3166 Baris ketiga alamat.
locality FULL, FULL-ISO3166 Kota, kawasan, atau pinggiran kota.
administrativeArea FULL, FULL-ISO3166 Subdivisi negara, seperti negara bagian atau provinsi.
sortingCode FULL, FULL-ISO3166 Kode pengurutan.
iso3166AdministrativeArea FULL-ISO3166 Kode wilayah administratif ISO 3166-2 yang sesuai dengan administrativeArea.

Contoh

Berikut contoh alamat dengan format FULL-ISO3166 di Amerika Serikat dengan beberapa baris data alamat jalan.

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}