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

IsReadyToPayResponse

Đối tượng này cung cấp thông tin về khả năng của khách truy cập trang web trong việc cung cấp thông tin thanh toán cho trang web yêu cầu thông tin đó.

Ví dụ

Ví dụ sau đây cho bạn biết thời điểm khách truy cập hiện tại có thể cung cấp thông tin thanh toán cho trang web yêu cầu thông tin đó.

{
  "result": true
}

PaymentData

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

Ví dụ

Ví dụ về phản hồi này cho Google Pay API phiên bản 2.0 cho thấy phương thức thanh toán CARD được chọn trong bảng thanh toán của Google Pay. Đã tạo mã thông báo phương thức thanh toán cho cổng thanh toán example.

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

IntermediatePaymentData

Đối tượng này được trả về bởi dữ liệu đầu vào onPaymentDataChanged() của API Google Pay khi địa chỉ giao hàng hoặc phương thức vận chuyển thay đổi trong trang thanh toán.

Ví dụ

Ví dụ này cho thấy tải trọng trung gian được trả về từ Google Pay API khi có thay đổi về địa chỉ giao hàng.

{
  "callbackTrigger": "SHIPPING_ADDRESS",
  "offerData": {
    "redemptionCode": "exampleCode"
  },
  "shippingAddress": {
    "administrativeArea": "NY",
    "countryCode": "US",
    "locality": "New York",
    "postalCode": "10011"
  },
  "shippingOptionData": {
    "id": "shipping-001"
  }
}

Ví dụ này cho thấy tải trọng trung gian được trả về khi phương thức thanh toán thay đổi.

{
  "callbackTrigger": "PAYMENT_METHOD",
  "paymentMethodData": {
    "type": "CARD",
    "info": {
      "cardNetwork": "VISA",
      "cardFundingSource": "CREDIT",
      "billingAddress": {
        "administrativeArea": "NY",
        "countryCode": "US",
        "locality": "New York",
        "postalCode": "10011"
      }
    }
  }
}

PaymentMethodData

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

Ví dụ

Ví dụ về phản hồi này cho thấy cách một phương thức thanh toán CARD được chọn trong trang thanh toán của Google Pay tạo mã thông báo phương thức thanh toán cho cổng thanh toán 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.

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 trên thông tin xác thực 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 phương thức thanh toán.

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 của đối tượng Request.

PaymentMethodTokenizationData

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

Ví dụ

Đây là ví dụ về phản hồi được mã hoá và chuẩn bị cho cổng thanh toán example.

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

PaymentAuthorizationResult

Đối tượng này cung cấp thông tin về kết quả uỷ quyền thanh toán.

Ví dụ

Ví dụ sau đây cho thấy kết quả thanh toán được trả về sau khi một khoản thanh toán được xử lý:

{
  "transactionState": "ERROR",
  "error": {
    "reason": "PAYMENT_DATA_INVALID",
    "message": "Cannot pay with payment credentials",
    "intent": "PAYMENT_AUTHORIZATION"
  }
}

PaymentDataError

Ví dụ

Ví dụ này cho thấy ý định và thông báo lỗi sẽ hiển thị trong trang thanh toán.

{
  "error": {
    "reason": "SHIPPING_OPTION_INVALID",
    "message": "This shipping option is invalid for the given address",
    "intent": "SHIPPING_OPTION"
  }
}

Đị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ả thuộc tính đều là chuỗi.

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

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

IntermediateAddress

Địa chỉ trung gian chứa địa chỉ giao hàng đã được loại bỏ thông tin nhạy cảm (không có dòng địa chỉ cấp đường phố hoặc tên người nhận) để cho phép tính thuế và các lựa chọn giao hàng hiện hành trước khi người dùng cho phép thanh toán.

Ví dụ

Ví dụ này cho bạn thấy địa chỉ được chọn trong trang thanh toán.

{
  "administrativeArea": "NY",
  "countryCode": "US",
  "locality": "New York",
  "postalCode": "10011"
  "iso3166AdministrativeArea": "US-NY"
}

SelectionOptionData

Ví dụ

Ví dụ này cho bạn thấy lựa chọn vận chuyển được chọn trong trang thanh toán.

{
  "id": "shipping-001"
}

OfferData

Đối tượng này cung cấp thông tin về mã ưu đãi được nhập vào trang thanh toán.

Ví dụ

Ví dụ sau đây cho thấy một đối tượng OfferData có mảng redemptionCodes.

"offerData": {
    "redemptionCodes": ["PROMOTIONALCODE"]
}

IntermediatePaymentMethodData

Đối tượng này chứa một số thông tin về phương thức thanh toán đã chọn cho lệnh gọi lại của nhà phát triển.

IntermediateCardInfo

Đối tượng này chứa thông tin giới hạn về thẻ đã chọn, được dùng trong lệnh gọi lại của nhà phát triển.