Đối tượng phản hồi JSON

Tài liệu tham khảo này mô tả các lựa chọn đối tượng phản hồi của Google Pay API để sử dụng với ứng dụng của bạn. Đối tượng phản hồi là các đối tượng do phương thức ứng dụng khách của Google Pay API trả về.

PaymentData

Đây là một đối tượng phản hồi do Google trả về sau khi người thanh toán phê duyệt khoản thanh toán.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Thuộc tính Loại Luôn tồn tại Mô tả
apiVersion số Có Phiên bản API chính. Giá trị trong phản hồi khớp với giá trị được cung cấp trong
apiVersionMinor số Có Phiên bản API phụ. Giá trị trong phản hồi khớp với giá trị được cung cấp trong
paymentMethodData PaymentMethodData Có Dữ liệu về phương thức thanh toán đã chọn.
email chuỗi Không Địa chỉ email, nếu emailRequired được đặt thành true trong PaymentDataRequest. Nếu một yêu cầu khác có thuộc tính được đặt thành true thì sẽ không có hiệu lực.
shippingAddress Địa chỉ Không Địa chỉ giao hàng, nếu shippingAddressRequired được đặt thành true trong

Ví dụ:

Phản hồi mẫu này cho Google Pay API phiên bản 2.0 cho thấy một phương thức thanh toán CARD được chọn trong trang thanh toán của Google Pay. Một mã thông báo phương thức thanh toán đã được tạo cho cổng 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

Đối tượng này cung cấp dữ liệu cho một phương thức thanh toán đã chọn.

Thuộc tính Loại Luôn tồn tại Mô tả
type chuỗi Có PaymentMethod type được chọn trong trang thanh toán của Google Pay.
description chuỗi Có

Thông báo cho người dùng để mô tả phương thức thanh toán dùng để thanh toán giao dịch này.
info đối tượng Có Giá trị của thuộc tính này phụ thuộc vào phương thức thanh toán type được trả về. Đối với CARD, hãy xem CardInfo.
tokenizationData PaymentMethodTokenizationData Không Dữ liệu mã hoá thông tin thanh toán cho phương thức thanh toán đã chọn.

Ví dụ:

Phản hồi mẫu này cho biết cách một phương thức thanh toán CARD được chọn trong trang thanh toán Google Pay sẽ tạo mã thông báo phương thức thanh toán cho cổng example.

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

CardInfo

Đối tượng này cung cấp thông tin về thẻ thanh toán đã chọn.

Thuộc tính Loại Luôn tồn tại Mô tả
cardDetails chuỗi Có Thông tin chi tiết về thẻ. Giá trị này thường là 4 chữ số cuối của số tài khoản thanh toán đã chọn.
assuranceDetails AssuranceDetailsSpecifications Có Đối tượng này cung cấp thông tin về quy trình xác thực được thực hiện trên dữ liệu thanh toán đã trả về nếu assuranceDetailsRequired được đặt thành true trong CardParameters.
cardNetwork chuỗi Có

Mạng thanh toán của thẻ thanh toán đã chọn. Các giá trị được trả về khớp với định dạng của allowedCardNetworks trong CardParameters.

Người mua không được nhìn thấy giá trị mạng thẻ này. Được dùng khi cần thông tin chi tiết về thẻ của người mua. Ví dụ: nếu bộ phận hỗ trợ khách hàng cần giá trị này để xác định thẻ mà người mua đã dùng cho giao dịch. Để có nội dung mô tả mà người dùng có thể thấy, hãy sử dụng thuộc tính description của PaymentMethodData.
billingAddress Địa chỉ Không Địa chỉ thanh toán được liên kết với phương thức thanh toán đã cung cấp, nếu billingAddressRequired được đặt thành true trong CardParameters.
cardFundingSource chuỗi Có

Nguồn tiền từ thẻ cho phương thức thanh toán đã chọn.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Ví dụ:

Ví dụ này cho thấy một thẻ trên mạng Visa.

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

AssuranceDetailsSpecifications

Đối tượng này cung cấp thông tin về quy trình xác thực đã được thực hiện đối với thông tin đăng nhập thanh toán được trả về để có thể áp dụng các quy trình kiểm tra rủi ro phù hợp cho công cụ.

Tên Loại Mô tả
accountVerified boolean Nếu true, tức là quá trình xác thực quyền sở hữu Cardholder đã được thực hiện trên thông tin thanh toán được trả về.
cardHolderAuthenticated boolean

Nếu true, cho biết rằng quy trình nhận dạng và xác minh (ID&V) đã được thực hiện trên thông tin đăng nhập thanh toán được trả về.

Nếu false, bạn có thể thực hiện quy trình xác thực dựa trên rủi ro tương tự như đối với các giao dịch bằng thẻ. Quy trình xác thực dựa trên rủi ro này có thể bao gồm nhưng không giới hạn ở bước xác thực bổ sung bằng giao thức 3D Secure (nếu có).

Bạn có thể nhận và xử lý Đối tượng phản hồi ngay cả khi không sử dụng trường assuranceDetails. Để nhận đối tượng này, hãy thêm assuranceDetailsRequired: true vào CardParameters.

PaymentMethodTokenizationData

Đối tượng này cung cấp dữ liệu mã hoá cho phương thức thanh toán.

Thuộc tính Loại Luôn tồn tại Mô tả
type chuỗi Có Loại mã hoá kỹ thuật số sẽ được áp dụng cho phương thức thanh toán đã chọn. Giá trị này khớp với type được đặt trong PaymentMethodTokenizationSpecification.
token chuỗi Không

Mã thông báo phương thức thanh toán được tạo.

Ví dụ:

Đây là ví dụ về một phản hồi được mã hoá dưới dạng mã thông báo, được chuẩn bị cho cổng example.

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

Địa chỉ

Đối tượng này cung cấp thông tin về địa chỉ bưu chính được yêu cầu. Tất cả các thuộc tính đều là chuỗi.

Địa chỉ có thể được trả về ở định dạng MIN, FULL và FULL-ISO3166. Bạn có thể xem các thuộc tính thuộc từng định dạng trong bảng sau.

Thuộc tính Định dạng địa chỉ Mô tả
name MIN, FULL, FULL-ISO3166 Họ và tên đầy đủ của người nhận.
postalCode MIN, FULL, FULL-ISO3166 Mã bưu điện hoặc mã vùng.
countryCode MIN, FULL, FULL-ISO3166 Mã quốc gia ISO 3166-1 alpha-2.
phoneNumber MIN, FULL, FULL-ISO3166 Số điện thoại, nếu phoneNumberRequired được đặt thành true trong PaymentDataRequest.
address1 FULL, FULL-ISO3166 Dòng đầu tiên của địa chỉ.
address2 FULL, FULL-ISO3166 Dòng thứ hai của địa chỉ.
address3 FULL, FULL-ISO3166 Dòng thứ ba của địa chỉ.
locality FULL, FULL-ISO3166 Thành phố, thị trấn, khu phố hoặc vùng ngoại ô.
administrativeArea FULL, FULL-ISO3166 Một phân khu của quốc gia, chẳng hạn như tiểu bang hoặc tỉnh.
sortingCode FULL, FULL-ISO3166 Mã sắp xếp.
iso3166AdministrativeArea FULL-ISO3166 Mã khu vực hành chính theo ISO 3166-2 tương ứng với administrativeArea.

Ví dụ:

Đây là ví dụ về địa chỉ theo định dạng FULL-ISO3166 ở Hoa Kỳ có nhiều dòng dữ liệu địa chỉ đường phố.

{
  "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"
}