Instrumen pembayaran Google Pay

Referensi ini didasarkan pada skema Instrumen Pembayaran Kartu untuk objek instrumen pembayaran yang ditampilkan oleh handler pembayaran Google Pay setelah penyelesaian checkout di dalam array payment.instruments.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

Properti

Properti Jenis Selalu ada? Deskripsi
id string Ya ID unik untuk instance instrumen pembayaran ini, yang ditetapkan oleh platform.
handler_id string Ya ID unik untuk instance pengendali yang menghasilkan instrumen ini. Sesuai dengan kolom id dalam konfigurasi pengendali pembayaran.
type string Ya Jenis instrumen pembayaran, misalnya card.
selected boolean Tidak Menunjukkan apakah instrumen ini dipilih oleh pengguna.
display objek Ya Menampilkan informasi untuk instrumen pembayaran.
display.brand string Ya Merek/jaringan kartu (misalnya, "VISA").
display.last_digits string Ya 4 digit terakhir nomor kartu.
display.description string Tidak Deskripsi kartu yang ditampilkan kepada pengguna.
display.card_art string Tidak URI ke gambar yang mewakili kartu.
billing_address objek Tidak Alamat penagihan yang terkait dengan kartu. Hanya ditampilkan jika billing_address_required disetel ke true dalam konfigurasi.
billing_address.first_name string Tidak Nama depan kontak yang terkait dengan alamat.
billing_address.last_name string Tidak Nama belakang kontak yang terkait dengan alamat.
billing_address.street_address string Tidak Alamat.
billing_address.extended_address string Tidak Ekstensi alamat (misalnya, nomor apartemen atau suite).
billing_address.address_locality string Tidak Lokalitas (misalnya, kota).
billing_address.address_region string Tidak Wilayah (misalnya, negara bagian atau provinsi).
billing_address.postal_code string Tidak Kode pos.
billing_address.address_country string Tidak Kode negara (format ISO 3166-1 alpha-2 2 huruf).
billing_address.phone_number string Tidak Nomor telepon. Hanya ditampilkan jika phone_number_required disetel ke true dalam konfigurasi.
credential objek Tidak Data tokenisasi aman yang ditampilkan oleh Google Pay.
credential.type string Ya Jenis tokenisasi. Mencocokkan jenis yang dikonfigurasi.
  • PAYMENT_GATEWAY: Digunakan jika Anda memproses pembayaran melalui gateway yang didukung.
  • DIRECT: Digunakan jika Anda mendekripsi kredensial sendiri.
credential.token string Ya Token kredensial pembayaran terenkripsi sebagai string yang diserialisasi JSON.

Untuk PAYMENT_GATEWAY, ini berisi payload terenkripsi yang akan diteruskan ke gateway Anda. Untuk DIRECT, ini berisi detail kartu terenkripsi (memerlukan dekripsi menggunakan kunci pribadi Anda). Lihat panduan Kriptografi data pembayaran untuk mengetahui detail tentang format dan proses dekripsi.