API Giao dịch sẽ ngừng hoạt động từ ngày 3 tháng 5 năm 2023, trước khi hành động trò chuyện ngừng hoạt động từ ngày 13 tháng 6 năm 2023. Để biết thêm thông tin, hãy xem phần Hành động trò chuyện ngừng hoạt động.
Các lựa chọn thanh toán liên quan đến đơn đặt hàng.
Biểu diễn dưới dạng JSON
{// Union field payment_option can be only one of the following:"googleProvidedOptions": {object(GoogleProvidedPaymentOptions)},"actionProvidedOptions": {object(ActionProvidedPaymentOptions)}// End of list of possible types for union field payment_option.}
Trường
Trường kết hợp payment_option. Các lựa chọn thanh toán. payment_option chỉ có thể là một trong những trạng thái sau đây:
Trường bắt buộc để yêu cầu Google cung cấp phương thức thanh toán. Các thông số tạo mã thông báo này sẽ được dùng để tạo mã thông báo thanh toán dùng trong giao dịch. Ứng dụng phải nhận các thông số này từ cổng thanh toán.
Ứng dụng này cho phép thẻ từ bất kỳ mạng lưới thẻ nào có trong danh sách ở đây để dùng trong giao dịch. Theo mặc định, các thẻ Amex, Visa, MC và Discover được hỗ trợ.
prepaidCardDisallowed
boolean
Nếu đúng, không cho phép sử dụng thẻ trả trước trong giao dịch.
billingAddressRequired
boolean
Nếu đúng, địa chỉ thanh toán sẽ được trả về.
PaymentMethodTokenizationParameters
Đối tác PHẢI chỉ định các thông số tạo mã thông báo nếu phương thức thanh toán mà người dùng đã lưu với Google sẽ được dùng trong giao dịch. Đối tác phải có thể nhận được các thông số này từ Cổng thanh toán của riêng mình.
Nếu bạn đặt tokenizationType thành PAYMENT_GATEWAY, thì danh sách thông số phải chứa các thông số cụ thể của cổng thanh toán cần có để mã hoá phương thức thanh toán cũng như thông số có tên là "gateway" có giá trị được đặt thành một trong các cổng mà chúng tôi hỗ trợ, ví dụ: "sọc" hoặc "cây não". Một cấu hình mã hoá mẫu dùng cho Stripe ở định dạng JSON. {
"gateway" : "stripe",
"stripe:publishableKey" : "pk_1234",
"stripe:version" : "1.5"
} Cấu hình mã hoá mẫu được dùng cho Braintree ở định dạng JSON. {
"gateway" : "braintree",
"braintree:merchantId" : "abc"
"braintree:sdkVersion" : "1.4.0"
"braintree:apiVersion" : "v1"
"braintree:clientKey" : "production_a12b34"
"braintree:authorizationFingerprint" : "production_a12b34"
} Cấu hình mẫu được dùng cho Adyen ở định dạng JSON. {
"gateway" : "adyen",
"gatewayMerchantId" : "gateway-merchant-id"
} Nếu bạn đặt tokenizationType thành DIRECT, thì các đối tác tích hợp phải chỉ định một tham số có tên là "publicKey" Tệp này sẽ chứa khoá công khai Elliptic Curve sử dụng định dạng điểm không nén và mã hoá base64. Google sẽ sử dụng khoá công khai này để mã hoá thông tin thanh toán. Ví dụ về tham số ở định dạng JSON: { "publicKey": "base64enabled..." }
Một đối tượng chứa danh sách các cặp "key": value. Ví dụ: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
ActionProvidedPaymentOptions
Yêu cầu đối với phương thức thanh toán do Hành động cung cấp.
Tên của phương thức thanh toán trên biên nhận. Bắt buộc đối với thông tin thanh toán do hành động cung cấp. Đối với PAYMENT_CARD, giá trị này có thể là "VISA-1234". Đối với BANK, mã này có thể là "Chase Inspection-1234" (Theo dõi séc-1234). Đối với LOYALTY_PROGRAM, giá trị này có thể là "Starbuck's points". Đối với ON_FULFILLMENT, thông tin này có thể là "thanh toán khi nhận hàng".
[null,null,["Cập nhật lần gần đây nhất: 2024-08-21 UTC."],[[["This documentation details the deprecated Orders version 2 API for payment options associated with an order, recommending migration to Orders version 3."],["It outlines two main payment options: GoogleProvidedPaymentOptions, requiring specific parameters for using Google-saved payment methods, and ActionProvidedPaymentOptions, for payment methods provided within the Action."],["Both GoogleProvidedPaymentOptions and ActionProvidedPaymentOptions necessitate providing specific parameters and display names for a successful transaction."],["Developers should retrieve tokenization parameters from their payment gateway for GoogleProvidedPaymentOptions and define payment type and display name for ActionProvidedPaymentOptions."],["Card networks, prepaid card restrictions, and billing address requirements can be specified within GoogleProvidedPaymentOptions."]]],[]]