Phương thức thanh toán bằng Google Pay

Thông tin tham chiếu này dựa trên sơ đồ Phương thức thanh toán bằng thẻ cho đối tượng phương thức thanh toán do trình xử lý thanh toán Google Pay trả về khi hoàn tất quy trình thanh toán trong mảng 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
  }
}

Thuộc tính

Thuộc tính Loại Luôn có mặt? Mô tả
id chuỗi Có Giá trị nhận dạng duy nhất cho phiên bản phương thức thanh toán này, do nền tảng chỉ định.
handler_id chuỗi Có Giá trị nhận dạng riêng biệt của thực thể trình xử lý đã tạo ra công cụ này. Tương ứng với trường id trong cấu hình trình xử lý thanh toán.
type chuỗi Có Loại phương thức thanh toán, ví dụ: card.
selected boolean Không Cho biết liệu người dùng có chọn nhạc cụ này hay không.
display đối tượng Có Hiển thị thông tin về phương thức thanh toán.
display.brand chuỗi Có Thương hiệu/mạng lưới thẻ (ví dụ: "VISA").
display.last_digits chuỗi Có 4 chữ số cuối của số thẻ.
display.description chuỗi Không Nội dung mô tả thẻ mà người dùng nhìn thấy.
display.card_art chuỗi Không URI đến một hình ảnh đại diện cho thẻ.
billing_address đối tượng Không Địa chỉ thanh toán được liên kết với thẻ. Chỉ được trả về nếu billing_address_required được đặt thành true trong cấu hình.
billing_address.first_name chuỗi Không Tên của người liên hệ được liên kết với địa chỉ.
billing_address.last_name chuỗi Không Họ của người liên hệ được liên kết với địa chỉ.
billing_address.street_address chuỗi Không Địa chỉ đường phố.
billing_address.extended_address chuỗi Không Phần mở rộng địa chỉ (ví dụ: số căn hộ hoặc số nhà).
billing_address.address_locality chuỗi Không Vị trí (ví dụ: thành phố).
billing_address.address_region chuỗi Không Khu vực (ví dụ: tiểu bang hoặc tỉnh).
billing_address.postal_code chuỗi Không Mã ZIP/mã bưu chính.
billing_address.address_country chuỗi Không Mã quốc gia (định dạng ISO 3166-1 alpha-2 gồm 2 chữ cái).
billing_address.phone_number chuỗi Không Số điện thoại. Chỉ được trả về nếu phone_number_required được đặt thành true trong cấu hình.
credential đối tượng Không Dữ liệu mã hoá an toàn do Google Pay trả về.
credential.type chuỗi Có Loại mã hoá. Khớp với loại được định cấu hình.
  • PAYMENT_GATEWAY: Được dùng nếu bạn xử lý các khoản thanh toán thông qua một cổng được hỗ trợ.
  • DIRECT: Được dùng nếu bạn tự giải mã thông tin đăng nhập.
credential.token chuỗi Có Mã thông báo thông tin thanh toán đã mã hoá dưới dạng một chuỗi được chuyển đổi tuần tự thành JSON.

Đối với PAYMENT_GATEWAY, tham số này chứa tải trọng đã mã hoá để chuyển đến cổng của bạn. Đối với DIRECT, tham số này chứa chi tiết thẻ đã mã hoá (bạn phải giải mã bằng khoá riêng tư). Hãy xem hướng dẫn Mã hoá dữ liệu thanh toán để biết thông tin chi tiết về định dạng và quy trình giải mã.