本頁面由 Cloud Translation API 翻譯而成。

設定不同的付款方式

Actions Center 平台支援多種設定接受付款。啟用付款指南會說明整合的各方面所有付款整合項目通用，包括：

設定動態饋給來加入 tokenization_parameter 資訊
將預訂伺服器更新為接受「payment_method_token」物品
使用者與 Actions Center 之間交換的資訊總覽合作夥伴 / 商家和付款處理方。

本指南將進一步說明設定動態饋給，指定不同類型的動態饋給您的商家和服務都必須符合付款設定。

無須付款 / 抵達時付款
全額預付款
逾時未到費用 / 取消費
存款

付款的所有用途都是不付款 / 準時付費使用情境 (無須設定付款方式)，因此這類教學課程會先介紹該設定視為擴充功能

各節也會涵蓋要追蹤的欄位預訂伺服器，以便接受特定款項此外還會從 0 自動調整資源配置您完全不必調整資源調度設定

無須付款 / 抵達時付款

對於預約時無須付款的服務，商家或服務不需要進行付款設定第二，自訂角色只能套用至專案或機構不過，價格仍為必填。

這是服務的基準設定，其中包含名稱、說明和價格這可能是單一服務訊息內 ServiceFeed:

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-1-a",
    "name": "Men's haircut",
    "description": "One of our stylists will cut your hair",
    "price": {
        "price_micros": 15000000,
        "currency_code": "USD"
    }
}

除了標準實作外，不需額外設定，以便在抵達時支援付款功能。

預付款

這項設定可用來指定服務費用金額必須在預訂時全額付清。

您可以透過第 prepayment_type 個欄位是 Service。如要要求付費使用服務應設為 REQUIRED，如以下範例所示。請注意，指定價格的方式與支付到貨費用範例相同。在這裡由於我們將預付類型設為必填，因此信用卡會是，且結帳時會以這個價格計費。

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "prepayment_type": "REQUIRED"
}

預訂伺服器

接受預付後，系統會將付款代碼傳送至你的預訂呼叫 CreateBooking 透過欄位 payment_processing_parameters.unparsed_payment_method_token。您必須收取透過且須使用幣別指定的動態饋給這些費用應該依照的啟用付款指南。

傳回 CreateBookingResponse敬上「booking.payment_information」欄位必須正確設定反映已提供並處理的預付款。

PaymentInformation 規格包含所有付款資訊選項的說明文件。這個簡單的模型以下付款方式。完全符合請求。此外，如果動態饋給/要求中已指定稅率必須一併加入

另請注意，您必須提供交易 ID。這個交易 ID 在該商家的所有交易中，皆必須至少與其他商家不重複。A 罩杯適合交易 ID 的候選交易 ID 是指付款處理方。

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
}

逾時未到費用

如果使用者未參加或在取消預訂後取消取消期限。如果未指定取消時限預設為版位的開始時間。

如要指定逾時未到費用，請在服務動態饋給中加入 no_show_fee 欄位，如以下範例所示：

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    }
    "scheduling_rules": {
        "min_advance_online_canceling": 14400,
    }
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        }
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

就上述範例而言，合作夥伴或商家已獲得按照如果預約持有人是 no_show_fee.fee.price_micros 欄位不會參加預約。如果使用者點數會在預約時間的 4 小時 (14400 秒) 內取消，例如指定於 scheduling_rules.min_advance_online_canceling ] 欄位。

如要瞭解如何在供應情形層級定義逾時未到費用，請參閱：本節。

預訂伺服器

處理包含未支付費的要求時，付款權杖會在呼叫 CreateBooking 透過欄位 payment_processing_parameters.unparsed_payment_method_token。此 Token 的傳遞方式與預付方式相同確認是否屬於此情況不過，因為權杖授權的時間只有一小段時間您必須呼叫付款處理方的相關 API，將這個權杖升級至可持續使用的版本我們稍後會確認詳情請參閱《啟用付款指南》一節為未顯示費用權杖流程：

傳回 CreateBookingResponse敬上 booking.payment_information 欄位必須正確設定回應逾時未到費用的狀態，如以下範例所示。

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "no_show_fee": {
        "fee": {
            "price_micros": 25000000,
            "currency_code": "USD"
        }
        "fee_type": "FIXED_RATE_DEFAULT"
    }
}

請注意，no_show_fee 會設為反映價格，可能收費時採用的結構另請注意，與預付範例，請在這則訊息中加入 transaction_id。

另請注意，在booking_id CreateBookingResponse 是必填欄位，充電時必須傳送的即時更新資訊逾時未到費用這個 ID 通常會與資訊一起儲存關於預訂的資訊。

即時更新

使用者並未抵達原定的預訂行程或取消預訂在取消期限過後 (例如直接與您聯絡)，您將可選擇使用付款資訊收取指定的逾時未到費用也就是您在預訂時所儲存的收取逾時未到的費用時，必須即時更新：指明未收取節目費用。

適用於由以下服務建立的預訂： CreateBooking，更新應傳送至 notification.partners.bookings.patch。這項要求的主體應該是已更新的預訂，且狀態設為 NO_SHOW_PENALIZED。這個狀態會通知 Google 某筆費用執行。

例如，要求可能傳送至：

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status

包含要求主體：

JSON

{
    "name": "partners/12345678/bookings/123123123"
    "merchantId": "merchant-1"
    "serviceId": "service-2-b"
    "status": "NO_SHOW_PENALIZED"
}

存款

存款會用於收取第一筆費用預訂。可在預約時或稍後收取訂金讓應用程式從可以最快做出回應的位置回應使用者要求您可能需要在哪些條款之下定義可以退回押金的條款。以及可以線上取消預訂的情況

如要指定存款，請在服務動態饋給中加入 deposit 欄位，如以下範例所示：

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-2-b",
    "name": "Spa Treatment",
    "description": "A full spa treatment",
    "price": {
        "price_micros": 200000000,
        "currency_code": "USD"
    }
    "scheduling_rules": {
        "min_advance_online_canceling": 86400,
    }
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": USD,
            "min_advance_cancellation_sec": 14400,
        }
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

在這個範例中， min_advance_online_canceling 會定義取消期限，以及 deposit.min_advance_cancellation_sec。定義該筆存款可退款的時間。請注意，在上述範例中，存款可以指定取消時間與退款條款分開。在這種情況下，使用者可以自行取消長達 24 小時 (86400 秒)這能確保商家並在取消期限前直接收到通知不過，該使用者最晚 4 小時內符合退款資格 (14400 秒) 這項資訊會顯示在結帳時的條款和確認電子郵件中。

如要瞭解如何在供應情形層級定義存款方式，請參閱：本節。

預訂伺服器

處理包含存款的要求時，付款權杖會透過 CreateBooking 透過欄位 payment_processing_parameters.unparsed_payment_method_token。此權杖的傳遞方式與預付情況相同。如果發生以下情況：收取這筆金額，或是在預約時扣除保留款。。

如果您日後有興趣收取這筆存款，而是發出短時間授權，您必須呼叫付款處理方的相關 API，以便將這個權杖升級為以便日後持續使用這是，。

傳回 CreateBookingResponse，booking.payment_information 欄位必須正確回應存款狀態，如下例所示。

JSON

{
    "prepayment_status": "PREPAYMENT_PROVIDED",
    "payment_processed_by": "PROCESSED_BY_PARTNER",
    "payment_transaction_id": "[this-transaction-id]",
    "price": {
        "price_micros": "200000000",
        "currency_code": "USD"
    }
    "deposit": {
        "deposit": {
            "price_micros": 25000000,
            "currency_code": USD,
            "min_advance_cancellation_sec": 28800,
        }
        "deposit_type": "FIXED_RATE_DEFAULT"
    }
}

請注意，存款設定是以可能收取或保留的存款。另請注意，與預付範例，請在這則訊息中加入 transaction_id。

即時更新

如果使用者在取消訂金期限前取消預訂，您必須將您支付給使用者信用卡的所有保證金退還給您。時間退款時，您必須即時更新：指明這筆存款是否已退還。

適用於由以下服務建立的預訂： CreateBooking，更新應傳送至 notification.partners.bookings.patch。在本內文中要求必須是更新後的預訂，且狀態會設為 CANCELED和 paymentInformation.prepaymentStatus欄位已設為 PREPAYMENT_REFUNDED。讓 Google 知道該筆存款已退款。

例如，要求可能傳送至：

PATCH https://mapsbooking.googleapis.com/v1alpha/notification/partners/12345678/bookings/123123123?updateMask=status

包含要求主體：

JSON

{
    "name": "partners/12345678/bookings/123123123"
    "merchantId": "merchant-1"
    "serviceId": "service-2-b"
    "status": "CANCELED"
    "paymentInformation": {
      "prepaymentStatus": "PREPAYMENT_REFUNDED"
    }
    
}

需要信用卡

服務可能需要信用卡做為額外的用於驗證身分不過，請勿使用預付款、訂金或逾時未到費用。如果這些用途但應按照這些步驟明確設定。同時請注意，要求信用卡通常會導致這項服務的預訂量大幅下滑。

如要要求在結帳時提供信用卡，請設定「require_credit_card」欄位改為 REQUIRE_CREDIT_CARD_ALWAYS。

JSON

{
    "merchant_id": "merchant-1",
    "service_id": "service-1-a",
    "name": "Men's haircut",
    "description": "One of our stylists will cut your hair",
    "price": {
        "price_micros": 15000000,
        "currency_code": "USD"
    },
    "require_credit_card": "REQUIRE_CREDIT_CARD_ALWAYS"
}

預訂伺服器

處理包含信用卡規定的要求時，權杖會在呼叫 CreateBooking 透過欄位 payment_processing_parameters.unparsed_payment_method_token。此 Token 的傳遞方式與預付方式相同確認是否屬於此情況不過，因為權杖授權的時間只有一小段時間您必須呼叫付款處理方的相關 API，將這個權杖升級至可持續使用的版本我們稍後會確認

預訂伺服器回應不需要其他資訊而非付費使用案例中的情況

在供應情形層級覆寫價格

以上所有範例皆已指定價格 / 費用結構提供代管服務在多數情況下，這個服務等級的價格應設為然而，在某些情況下，更改付款結構是合理的做法特定的供應情形時段舉例來說，在下列情況中可透過在供應情形層級覆寫價格 / 費用來處理：

週二降價，每週六調漲。
下午 5:00 到 7:00 之間，服務時段不需支付演出費用。

下表列出每種付款 / 收費方式及應輸入的欄位使用在供應情形動態饋給中，即可覆寫服務層級定義。

付款方式	費用 / 價格定義	是否可覆寫？
抵達時付款	`Service.price`	價格可覆寫，期限為參照 `Availability.payment_option_id` `Merchant.payment_option`。
預付款	`Service.price`	價格可覆寫為參照 `Availability.payment_option_id` `Merchant.payment_option`。
逾時未到費用	`Service.no_show_fee`	`Availability.no_show_fee`
存款	`Service.deposit`	`Availability.deposit`
需要信用卡	`Service.require_credit_card`	`Availability.require_credit_card`

請注意，如要覆寫供應情形等級的價格，您必須先定義並設定商家層級的付款選項。此外，也會說明如何可供預訂的取消期，請參閱指南如何新增取消期間。