交易 API 將於 2023 年 5 月 3 日淘汰,並將於 2023 年 6 月 13 日淘汰。詳情請參閱「
對話動作已淘汰」。
MerchantPaymentMethod
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
欄位 |
paymentMethodGroup |
string
選用設定。付款方式所屬的群組 / 個人資料名稱。
|
paymentMethodId |
string
必要欄位。商家 / 動作所提供付款方式的 ID。請注意,如果商家/動作傳送了多種付款方式,則此 ID 不得重複。
|
paymentMethodDisplayInfo |
object (PaymentMethodDisplayInfo )
必要欄位。顯示這個付款方式的資訊。
|
paymentMethodStatus |
object (PaymentMethodStatus )
選用設定。付款方式的狀態。如果沒有顯示,系統會假設付款方式處於「確定」狀態。
|
PaymentMethodStatus
JSON 表示法 |
{
"status": enum (Status ),
"statusMessage": string
} |
欄位 |
status |
enum (Status )
|
statusMessage |
string
向使用者顯示的付款方式狀態訊息,例如「已過期」。只有在付款方式必須修正或不適用時,才需要填寫。
|
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-26 (世界標準時間)。
[null,null,["上次更新時間:2025-07-26 (世界標準時間)。"],[[["\u003cp\u003eThe \u003ccode\u003eMerchantPaymentMethod\u003c/code\u003e object represents a payment method provided by a merchant or action, including details like ID, display information, and status.\u003c/p\u003e\n"],["\u003cp\u003eEach payment method has a unique ID (\u003ccode\u003epaymentMethodId\u003c/code\u003e) and can belong to a group (\u003ccode\u003epaymentMethodGroup\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePaymentMethodDisplayInfo\u003c/code\u003e provides display details for the payment method.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003ePaymentMethodStatus\u003c/code\u003e indicates the current status of the payment method, including a user-facing message if needed.\u003c/p\u003e\n"]]],["Merchants/Actions provide payment methods, each with a unique `paymentMethodId`. Each method includes display information (`paymentMethodDisplayInfo`) and an optional status (`paymentMethodStatus`). The `paymentMethodStatus` object details the payment method's state using an enum `status` and a `statusMessage` for issues like expiration. The `paymentMethodGroup` field is used to categorize payment method. If the status is not present, it's assumed to be \"OK\".\n"],null,["# MerchantPaymentMethod\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [PaymentMethodStatus](#PaymentMethodStatus)\n - [JSON representation](#PaymentMethodStatus.SCHEMA_REPRESENTATION)\n\nPayment method provided by Merchant / Action.\n\n| JSON representation ||\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"paymentMethodGroup\": string, \"paymentMethodId\": string, \"paymentMethodDisplayInfo\": { object (/assistant/df-asdk/transactions/reference/physical/rest/v3/Order#PaymentMethodDisplayInfo) }, \"paymentMethodStatus\": { object (/assistant/df-asdk/transactions/reference/physical/rest/v3/MerchantPaymentMethod#PaymentMethodStatus) } } ``` |\n\n| Fields ||\n|----------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `paymentMethodGroup` | `string` Optional. The group / profile name that the payment method belongs to. |\n| `paymentMethodId` | `string` Required. Id of the payment method passed from merchant / action. Note this id is should be unique if multiple payment methods are sent from Merchant/Action. |\n| `paymentMethodDisplayInfo` | `object (`[PaymentMethodDisplayInfo](/assistant/df-asdk/transactions/reference/physical/rest/v3/Order#PaymentMethodDisplayInfo)`)` Required. Display info of this payment method. |\n| `paymentMethodStatus` | `object (`[PaymentMethodStatus](/assistant/df-asdk/transactions/reference/physical/rest/v3/MerchantPaymentMethod#PaymentMethodStatus)`)` Optional. Status of the payment method. If not present, the payment method is assumed to be in OK status. |\n\nPaymentMethodStatus\n-------------------\n\nStatus of a payment method\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"status\": enum (/assistant/df-asdk/transactions/reference/physical/rest/v3/Status), \"statusMessage\": string } ``` |\n\n| Fields ||\n|-----------------|------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `status` | `enum (`[Status](/assistant/df-asdk/transactions/reference/physical/rest/v3/Status)`)` |\n| `statusMessage` | `string` User facing message regarding the payment method status, i.e. \"Expired\". Only required when payment method requires fix or is inapplicable. |"]]