遵守強客戶身份驗證法規

了解線上信用卡付款的驗證規定。

簡介

監管機構與信用卡組織正推出新規定，以強化線上支付的安全性，並保護消費者免受詐騙侵害。其中許多法規均規定，線上支付必須採用「強化客戶驗證」(SCA) 。

• 歐洲： 經修訂的《支付服務指令》（PSD2）規定，線上支付交易必須採用「強化身份驗證」(SCA) ，但特定豁免情況或符合《支付服務指令 2》（out-of-scope）規定之情形除外。
• 日本： 根據日本 SCA 規定，線上信用卡交易必須使用 3D Secure (3DS) 驗證機制，惟部分交易類型可獲豁免。

3D Secure 2 (3DS 2.0) 是由 EMVCo 與卡片支付處理產業共同開發的一項技術，旨在確保合規性的同時，在安全性與流暢的結帳體驗之間取得平衡。3DS 2.0 是 Rapid API 網站內採用的解決方案，用以符合強式客戶驗證 (SCA) 法規。

本頁面說明受支援的「Rapid API」付款方式將受到何種影響，以及您在為旅客提供服務時，可採取哪些措施以符合相關規定。

合規要求

在需要進行「強化客戶驗證」（SCA）的國家/地區，啟用合規交易的步驟將視「記錄中的商家」是誰，以及款項如何支付給該商家而有所不同。Rapid API.

當貴組織是「記錄在案的商家」時

Expedia Affiliate Collect

使用 Expedia Affiliate Collect 進行的預訂不受 SCA 法規影響。無需對 Rapid API 的付款流程或 API 整合進行任何變更，即可符合合規要求。

然而，如果您是「記錄在案的商家」，並向旅客的信用卡金融卡或任何其他屬於《安全與信貸法》（SCA）規範範圍內的支付方式進行扣款，則您可能會受到該法規的影響。相關規定很可能要求在支付流程中採用 3DS 2.0 作為「SCA-compliant」解決方案。請聯絡您的支付服務供應商，進一步了解他們如何協助商家符合 SCA 規範，並避免交易失敗。

公司卡

若貴公司身為「記錄商」，且使用在實施 SCA 規定的國家所發行的信用卡或金融卡向 Rapid API 付款，則以下卡種可豁免 SCA 要求：

• 一次性虛擬卡
• 此為發給貴公司的企業卡，而非發給個人

若您不希望使用上述列出的 SCA-exempt 卡，貴機構可直接向發卡銀行申請豁免。若獲准豁免，該卡的交易將無需進行驗證，惟可能需透過 3DS 2.0 進行「one-time」線上驗證。此項「one-time」要求可能因銀行而異。請注意，從申請到通過豁免可能需要很長時間；此外，若發生任何詐騙交易，銀行可能會要求貴公司負責。

當 Rapid API 擔任正式商家時

若貴公司透過將旅行者卡寄送至 Rapid，並以 Rapid API 作為記錄商，則可能會受到相關法規的影響。當旅客透過線上管道預訂，且未經由實體旅行社時，相關法規規定付款交易必須由旅客透過「強化客戶驗證」（SCA）進行驗證。針對此項要求，SCA-compliant 的處理流程是在付款過程中使用 3DS 2.0。若貴機構希望將 Rapid API 作為「記錄中的收單機構」，並處理任何在實施 SCA 規定的國家/地區發行的信用卡或借記卡交易，您需要採用我們的 SCA 解決方案。

透過零售代理或客服中心代理進行的交易，無需符合《強化客戶盡職調查法》（SCA）的要求。只要註明預訂是由專人協助辦理，交易就符合規定。如有需要，可在「供應情況 API」的 sales_channel 欄位加註。

當旅宿擔任正式商家時

若貴公司使用旅宿收集資料，您可能會受到相關法規的影響。在某些情況下，旅宿可能會在旅客不在場的情況下嘗試從其卡片扣款，例如收取「未到場」費用或押金。若未在扣款前進行 3DS 2.0 驗證，這些扣款將不被視為 SCA-compliant。若貴機構希望針對使用任何由實施 SCA 規定的國家所發行的信用卡或簽帳金融卡的旅客，採用旅宿收款服務，則需採用我們的 SCA 解決方案。

Rapid API 解決方案

運作方式

若您使用 Rapid API 作為「記錄中的商家」，或使用旅宿透過旅行者卡進行收款，即可採用 Rapid 的 API 解決方案，生成符合 SCA 法規的預訂。我們的 API 透過在預訂流程中採用 3DS 2.0，以符合 SCA 規範。透過 3DS 2.0，我們支援「risk-based」驗證機制，此機制賦予銀行酌情決定何時要求旅客進行安全驗證的權限，從而降低旅客的交易摩擦。

3DS 2.0 的解決方案包含三個明確的步驟：

1. 您將新增一個 iframe 前往 check-out 頁面，該頁面用於提供發卡銀行為旅客提供的驗證服務。在整合文件中，這被稱為 3DS iframe。
2. 您還需在 check-out 頁面中加入新的 client-side JavaScript 函式庫，該函式庫用於收集瀏覽器資料、與 iframe 進行通訊，並在 iframe 內顯示 SCA 體驗。在整合文件中，這被稱為 3DS 連接器函式庫。
3. Rapid API 系統將接受銀行的付款人資訊，並在完成安全驗證後完成預訂。

當同時使用 JavaScript 和 Rapid API 時，採用 SCA 的預訂流程現在會在呼叫 Booking API 之前和之後增加幾個額外步驟。下圖為更新後的預訂流程：

更新後的預訂流程中，上一步驟的輸出資料用做下一步驟的輸入資料。也就是資料會在瀏覽器的 JavaScript 和 Rapid 之間傳輸。

請注意：上圖為實際 API 流程的簡化版，做為初步說明之用。完整 API 流程請參閱整合相關文件。

整合所需元件詳細說明

瀏覽器 iframe

此 iframe 嵌入於 check-out 體驗中，並載入旅客所屬銀行 card-issuing 的網址。此網址將向使用者顯示驗證流程，並將任何「traveler-supplied」資訊直接傳送至其銀行。該 iframe 應預設為隱藏狀態，並能在用戶嘗試預訂後需進行身份驗證時，將其疊加顯示於頁面之上。

瀏覽器 JavaScript Library

此函式庫已新增至 check-out 頁面，並會在預訂時被呼叫以支援驗證流程。其 API 支援以下功能：

自動收集旅客裝置上的資料

在嘗試預訂之前，必須先收集旅客裝置的相關資訊，以便為驗證程序做好預訂準備。該資訊會傳送至旅客的 issuing-bank 進行審核，以便銀行評估風險、決定該筆交易是否需要進行 3DS 2.0 驗證，並確保其顯示正確。根據 3DS 2.0 規範，系統將從旅客的瀏覽器收集以下資料：語言、色彩深度、螢幕高度、螢幕寬度、時區、使用者代理程式，以及 Java 是否已啟用。

在瀏覽器的 iframe 中顯示驗證流程

進行預訂後，JavaScript Library 會用來顯示 iframe 置入的網頁，並將銀行網頁內容載入 iframe。在驗證過程中，銀行可能會收集有關旅客裝置的額外資訊，以協助進行風險評估。此為完成預訂的必要過程。

Rapid API

Rapid API 包含可與 client-side JavaScript 函式庫協同運作的 API。這些 API 目前支援以下功能：

登記旅客及付款詳情

在嘗試預訂之前，必須先收集旅客的相關資訊，以便準備預訂資料以供驗證。這些資料包括銷售點和付款等旅客帳戶詳情。這些資料隨後會傳送至旅客的 issuing-bank 進行審核，以便銀行評估風險，並決定該筆交易是否需要進行安全驗證。如需進一步了解，請參閱「」快速預訂 API 中的「註冊付款 API」：。

完成付款並確認預訂

在嘗試透過 Rapid API 進行預訂，且瀏覽器上的 SCA 流程完成後，必須再次呼叫 Rapid。在後台，我們會確認驗證確實成功，以便確認預訂。如需進一步了解，請參閱《Rapid Booking API》中的「完整付款流程」章節：。

預訂流程

若在「合作夥伴檔案快速支援」中啟用了 3DS 2.0，則「」價格查詢 API 將返回指向「註冊付款」 API 的連結，而非「建立預訂」API。下圖所示為旅客下訂後的 API 所需呼叫順序，包括對 JavaScript Library 和對 Rapid 的呼叫。

當預訂資料準備好進行驗證時，未必總是需要驗證。是否需要驗證，由用於付款的信用卡發卡銀行決定。此判定是在交易過程中進行的，並會顯示於Create Booking API 的回應中。

下圖所示為使用「暫停與繼續處理 API」所需的呼叫順序：

請注意：以上圖示皆為實際 API 流程的簡化版，做為初步說明之用。完整 API 流程請參閱整合相關文件。

如需進一步了解 3DS 2.0 體驗的技術要求，請參閱 EMVCo 的 3D Secure 協定與核心功能規範。

Rapid API 以及 3DS 2.0 整合指南

要支援 SCA，必須將 Rapid API 與一個名為「3DS Connector」的新 JavaScript 函式庫進行整合。這兩項功能會配合使用，以便在「check-out」頁面上顯示 3DS 2.0 並確認預訂。此解決方案支援 Expedia Collect 和入住時付款兩種商業模式。

以下概述了支援 3DS 2.0 預訂所需的 API 呼叫順序，詳細內容請參閱後續各節：

1. JavaScript 設定方法
2. Rapid 註冊付款 API
3. JavaScript 初始化工作階段方法
4. Rapid 預訂 API
5. JavaScript Challenge 方法
6. Rapid 完成付款 API

若要啟用此流程，Rapid Partner Support 必須為個別合作夥伴檔案啟用 3DS 2.0。

Rapid API

若已為合作夥伴檔案啟用驗證功能，API 回應將有所不同，以便支援採用 3DS 2.0 的更新版預訂流程。

可用性 API

若法規允許豁免驗證，API 請求中的 ``sales_channel 欄位值必須準確無誤。發卡銀行會在預訂時綜合考量此數值及其他多項因素，以做出決定。僅代理工具不受《安全通信法》（SCA）規範。若需註明此項目，請把 sales_channel 的值設為 agent_tool。

價格檢查 API

API 會回傳連結到「註冊付款 API」，而不是到「建立預訂 API」。

啟用 3DS 2.0 時的範例回應：

{
    "status": "matched",
    "occupancies": {
        //...(example omitted for length)
    },
    "links": {
        "payment_session": {
            "method": "POST",
            "href": "/v3/payment-sessions?token=QldfCGlcUAVgBDRwdWXBBL"
        }
    }
}

註冊付款 API

這將是 SCA 預訂流程中的第二個步驟，發生在 JavaScript setup方法之後。

該請求將包含作為 non-SCA 預訂流程一部分的付款詳細資訊，以及用於確認驗證成功的全新欄位。其中兩個欄位：encoded_browser_metadata 和 version 是從 JavaScript API 的 setup method 回傳。

回應中會包括 payment_session_id 和 encoded_init_config，並成為 JavaScript Library initSession 方法的輸入資料。應在呼叫initSession 方法後，使用回覆中包含的預訂連結。

請求範例：

{
    "version": "1",
    "browser_accept_header": "*/*",
    "encoded_browser_metadata": "ZW5jb2RlZF9icm93c2VyX21ldGFkYXRh",
    "preferred_challenge_window_size": "medium",
    "merchant_url": "https://server.adomainname.net",
    "customer_account_details": {
        "authentication_method": "guest",
        "authentication_timestamp": "2027-02-12T11:59:00.000Z",
        "create_date": "2027-09-15",
        "change_date": "2027-09-17",
        "password_change_date": "2027-09-17",
        "add_card_attempts": 1,
        "account_purchases": 1
    },
    "payments": [
        {
            "type": "customer_card",
            "card_type": "VI",
            "number": "4111111111111111",
            "security_code": "123",
            "expiration_month": "08",
            "expiration_year": "2027",
            "billing_contact": {
                "given_name": "John",
                "family_name": "Smith",
                "email": "smith@example.com",
                "phone": "4875550077",
                "address": {
                    "line_1": "555 1st St",
                    "line_2": "10th Floor",
                    "line_3": "Unit 12",
                    "city": "Seattle",
                    "state_province_code": "WA",
                    "postal_code": "98121",
                    "country_code": "US"
                }
            },
            "enrollment_date": "2027-09-15"
        }
    ]
}

回應範例：

{
    "payment_session_id": "76d6aaea-c1d5-11e8-a355-529269fb1459",
    "encoded_init_config": "QSBiYXNlNjQgZW5jb2RlZCBvYmplY3Qgd2hpY2ggY29udGFpbnMgY29uZmlndXJhdGlvbiBuZWVkZWQgdG8gcGVyZm9ybSBkZXZpY2UgZmluZ2VycHJpbnRpbmcgYW5kL29yIDNEUyBNZXRob2Qu",
    "links": {
        "book": {
            "method": "POST",
            "href": "/v3/itineraries?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
        }
    }
}

建立預訂 API

這將是 SCA 預訂流程中的第四個步驟，發生在 JavaScript initSession方法之後。該請求不會包含任何新的 SCA 欄位——所有必要資訊均包含在「註冊付款 API」所返回的預訂連結代碼中。若回應成功，一定會包含 itinerary_id。然而，這並不代表預訂已確認，因為可能需要進行 3DS 2.0 驗證。

如有需要，回覆中亦將包含一個 encoded_challenge_config. 從「註冊付款」回傳的 encoded_challenge_config 和 payment_session_id 必須用為參數傳入 JavaScript challenge 方法。

回應還會包括用來 complete_payment_session 的新連結。此連結應於 JavaScript Library 的 challenge 方法之後使用。

若無需進行 3DS 2.0 驗證，預訂即告確認，回應中將包含retrieve、cancel 以及 (可選)resume 的連結。

範例：若需進行 3DS 2.0 驗證，請建立「建立預訂」回應：

{
    "itinerary_id": "8999989898988",
    "links": {
        "complete_payment_session": {
            "method": "PUT",
            "href": "/v3/itineraries/8999989898988/payment-sessions?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
        }
    },
    "encoded_challenge_config": "ABElifsiejfacies2@033asfe="
}

完成付款工作階段 API

這將是 SCA 預訂流程中的第六個步驟，發生在 JavaScript challenge方法之後。此 API 用於完成付款，並通知 Rapid API 已進行安全驗證嘗試，無論是否成功。

該請求不會包含任何新的 SCA 欄位。

若回應成功，其中將包含預訂的確認資訊，包括預訂確認碼 (itinerary_id) 以及retrieve、cancel 的連結，以及 (視情況而定)resume 的連結。

回應範例：

{
    "itinerary_id": "8999989898988",
    "links": {
        "retrieve": {
            "method": "GET",
            "href": "/v3/itineraries/8999989898988?token=MY5S3j36cOcLfLBZjPYQ1abhfc8CqmjmFVzkk7euvWaunE57LLeDgaxm516m"
        }
    }
}

Iframe 與 JavaScript 函式庫的實作

使用 SCA 預訂工作流程時，check-out 頁面必須包含一個新的 iframe 以及 JavaScript 函式庫。此 iframe (稱為 3DS iframe) 將透過 3D-Secure 2.0。而 JavaScript Library (稱為 3DS Connector Library) 則負責傳送資料給發卡銀行，並把銀行的內容載入 iframe。

加入 iframe

3DS iframe 應包在開始時為隱藏的容器中，當付款程序判定為必須進行驗證時，則會再顯示。

容器設計可配合裝載頁面來自訂。以下為使用 Bootstrap 模態框顯示的執行範例，僅供參考。

<div id="threeDsIframeModal" class="modal" role="dialog">
    <div class="modal-dialog" role="document">
        <div class="modal-content">
            <div class="modal-body iframe-container">
                <div class="embed-responsive embed-responsive-16by9">
                    <iframe id="threeDsIframe" src="<<3DS iframe URL>>"> </iframe>
                </div>
            </div>
        </div>
    </div>
</div>

iframe 的源 (source) 必須設為以下兩個值之一：

上列測試 URL 可支援測試，下文會再回到這個主題。若要在測試期間限制 iframe 的內容，可為 iframe 設定 sandbox 屬性，但必須允許以下操作：

sandbox = 'allow-scripts allow-forms allow-same-origin';

加入 JavaScript 函式庫

3DS Connector Library 負責和 3DS iframe 溝通，並傳送資料給發卡銀行；銀行為 iframe 內容提供者。以下範例顯示如何將 3DS Connector Library 新增到付款頁面。

<head>
    <script src="<<3DS connector script URL>>" integrity="<<actual integrity value>>"></script>
</head>

Script 元素的 source 和 integrity 屬性應設定為以下值。

注意： 隨著未來版本陸續推出，原始網址及完整性將會有所變更。新版不會破壞現有的整合。舊版的 script 元素仍可存取。

使用 3DS 和 JavaScript 進行 SCA

JavaScript Library 需使用 JavaScript Promise 物件。下圖為執行範例，顯示 JavaScript 方法和 Rapid 之間如何交換數據，僅供參考。

// Initialize the library
let connector = new PayThreeDSConnector.ThreeDSConnector("threedsiframe", "https://static.pay.expedia.com");
RapidIntegration.priceCheck(priceCheckLink)
  .then(priceCheckResponse => {
    paymentSessionLink = priceCheckResponse.links.payment_session.href;
    // Setup an authentication session with the library
    return connector.setup({ referenceId: ’1000’ })
  }).then(setupResponse => {
    console.log("Setup Response: ", setupResponse);

    // Send information from setup to Rapid’s Register Payments API
    return RapidIntegration.registerPayment(paymentSessionLink,
           setupResponse);
  }).then(paymentSessionResponse => {
    console.log("Register Payments Response: ", paymentSessionResponse);
    paymentSessionId = paymentSessionResponse.paymentSessionId;
    bookLink = paymentSessionResponse.links.book.href;
    if (paymentSessionResponse.encoded_init_config) {
      // If the payment session response contains an encoded_init_config
      // field, initialize an authentication session with the library
      // using information returned from Rapid’s Register Payments API
      connector.initSession({
        paymentSessionId: paymentSessionId,
        encodedInitConfig: paymentSessionResponse.encodedInitConfig
      }).then(initSessionResponse => {
        console.log("Init Session Response: ", initSessionResponse);
        // Then create a booking with Rapid’s Book API
        return RapidIntegration.createBooking(bookLink,
               paymentSessionId);
      })
    } else {
      // Otherwise, create a booking with Rapid’s Book API directly
      return RapidIntegration.createBooking(bookLink, paymentSessionId);
    }
  }).then(createBookingResponse => {
    console.log("Create Booking Response: ", createBookingResponse);
    itineraryId = createBookingResponse.itinerary_id;
    if (createBookingResponse.encoded_challenge_config) {
      // If the Create Booking API contains an encoded_challenge_config field,
      // display the authentication challenge window
      $(’#threeDsIframeModal).modal(’show’);
      completePaymentSessionLink = createBookingResponse.links.complete_payment_session.href;
      // Perform the challenge using the information returned from Rapid’s Register Payments API
      // and Create Booking API
      connector.challenge({
        paymentSessionId: paymentSessionId,
        encodedChallengeConfig: createBookingResponse.encodedChallengeConfig
      }).then(challengeResponse => {
        console.log("Challenge Response: ", challengeResponse);
        // Complete a booking with Rapid’s Complete Payment Session API
        return RapidIntegration.completePaymentSession(completePaymentSessionLink, itineraryId);
      }).then(completePaymentSessionResponse => {
        console.log("Complete Payment Session Response: ", completePaymentSessionResponse);
        return completePaymentSessionResponse;
      }).finally(() => {
        // Close the authentication challenge window
        $(’#threeDsIframeModal’).modal(’hide’);
      });
    } else {
      return createBookingResponse;
    }
  }).then(bookingResponse => {
    ...
  });

備註：RapidIntegration 類別的參考也是範例內容，而非 3DS Connector Library 內容，旨在示範可支援資料傳輸到 API 的封套資料。

範例中使用靜態變數為參數，執行時應另行決定，如 referenceId。

Check-out 頁面設計指南

支援 3DS 驗證的信用卡品牌可能會要求，其標誌和品牌標識須依照其指引進行展示。

備註：待其他卡別的商標和使用辦法公布時會再納入此表。

3DS Connector JavaScript Library 相關文件

類別 (Class)：ThreeDSConnector

建構函式： new ThreeDSConnector(threeDsIFrameId, threeDsIFrameOrigin)

參數：

設定

透過收集後端 3DS 服務所需的瀏覽器基本資訊 (例如螢幕尺寸、色彩深度等)，來設定付款流程。

方法簽名： setup(setupRequest)

參數：

回傳： 承諾 SetupResponse

初始化

初始化用於 3DS 驗證的會話。進行初始化可能需要從瀏覽器收集其他資料。若發卡機構提出要求，iframe 可載入 3DS URL 來啟動發卡機構的存取控制伺服器 (Access Control Server)，直接從瀏覽器收集資料。用戶端不必等待回呼完成，於建立命令前即可調用。

方法簽名： initSession(initSessionRequest)

參數：

回傳： 承諾 InitSessionResponse

挑戰 (Challenge)

若發卡機構有此要求，請載入 3DS 驗證流程。

方法簽名： challenge(challengeRequest)

參數：

回傳： 承諾 ChallengeResponse

類別 (Class)：SetupRequest

設定呼叫的需求架構。

性質：

類別 (Class)：SetupResponse

來自設定呼叫的回應。

性質：

類別 (Class)：InitSessionRequest

initSession 方法的需求架構。

性質：

類別 (Class)：InitSessionResponse

initSession 方法的回應結構。

性質：

statusCode 可能會有以下的值：

注意：對於所有initSessionresponse statusCode 值，請使用快速預訂 API。

類別 (Class)：ChallengeRequest

挑戰 (Challenge) 方法的需求架構。

性質：

statusCode 可能會有以下的值：

注意：對於所有challengeResponse statusCode 值，請使用 Rapid API 以完成整個付款流程。

使用 Rapid API 和 3DS 2.0 進行測試

您可以透過輸入對應於 API 所支援之特定情境的參數值，來測試您與 Rapid API 以及 3DS 連接器方法的整合。

Rapid API

若要測試 Rapid API,，請在 HTTP 請求中加入名為test 的額外 HTTP 標頭，並使用該 API 支援的其中一個值來測試受支援的場景。

在 SCA 預訂流程中，亦可使用來自 Rapid API 的測試回應來測試 3DS 連接器函式庫的方法。

註冊付款 (Register Payments)

以下測試標頭值在 API 回應中會產生不同 encoded_init_config，以及不同 HTTP 回應碼。encoded_init_config 可傳入 JavaScript Library 的 initSession 呼叫，以啟動 3DS Connector Library 中的不同測試用例。

備註：init_skip 3DS Connector Library.t_config 裡的不同測試案例可傳到 initSession，便會強行產生名為 SKIPPED 的 statusCode。

建立預訂

除了在Rapid Booking Test Requests 中為 non-SCA 預訂流程所定義的測試標頭外，SCA 工作流程還支援其他測試標頭值。

測試標頭值會產生不同的 encodedChallengeConfig 值，這些值可傳入 JavaScript Library 的 challenge 呼叫，以觸發不同的測試案例。

完成付款工作階段

在試著完成付款並確認預訂時，測試標頭值會產生不同錯誤情況。

3DS Connector Library 和 iframe

在無外部相依關係下測試 3DS Connector 時，需使用符合支援方法回應的特定參數值。僅限 iframe 用測試沙箱 URL 載入時才支援這種做法。

初始化工作階段

InitSessionResponse statusCode 所支援的值可用變更 initSessionRequest encodedInitConfig 的方法來測試。

注意：encoded_init_config 值也可以使用「註冊付款 API」支援的測試標頭產生。

挑戰 (Challenge)

challengeResponse statusCode 所支援的值可用變更 challengeRequest encondedChallengeConfig 的方法來測試。

此外，也可透過 Booking API 的 SCA 流程所支援的測試標頭來產生encodedInitConfig 的值。

注意：當根據使用者在 iframe 中的輸入，測試挑戰狀態碼值為 SUCCESS 或 FAILED 時，挑戰方法的回應將等待 iframe 中的模擬驗證介面完成。

3DS iframe 中的 UI 範例：

用法範例

以下為執行範例，僅供參考。範例中可看到如何使用預先定義的值來測試 Library 進行 3DS 挑戰，而不需要使用者與 iframe 互動。

var c = new PayThreeDSConnector.ThreeDSConnector(’threedsiframe’, ’https://static.pay.expedia.com’); // change to match the 3DS iframe ID
c.setup({ referenceId: ’1000’ })
    .then((setupResponse) => {
        console.log(’Setup Output: ’, setupResponse);
        return c.initSession({
            paymentSessionId: 1,
            encodedInitConfig: ’ W3sicHJvdmlkZXJJZCI6IDAsICJzYW5kYm94SW5pdE91dHB1dENvbmZpZyI6ICJTVUNDRVNTIn1d’,
        }); // SUCCESS
    })
    .then((initResponse) => {
        console.log(’InitSession Output: ’, initResponse);
        $(’#threedsIframeModal’).modal(); // replace with code to show the modal containing the 3DS iframe
        return c.challenge({
            paymentSessionId: 1,
            encodedChallengeConfig:
                ’ W3sicHJvdmlkZXJJZCI6IDAsICJzYW5kYm94Q2hhbGxlbmdlT3V0cHV0Q29uZmlnIjogIlNVQ0NFU1MifV0=’,
        }); // SUCCESS
    })
    .then((challengeResponse) => {
        console.log(’Challenge Output: ’, challengeResponse);
    })
    .finally(() => {
        $(’#threedsIframeModal’).modal(’hide’); // replace with code to hide the modal containing the 3DS iframe
    });

3DS 驗證與旅宿收集

透過旅宿預訂並選擇「到店取房」時，Expedia 不會向您的信用卡扣款。相反地，我們會將它轉交給旅宿處理。旅宿可能會用收到的資訊在入住前先進行信用卡驗證。旅客須親臨以下地點付款 check-in.

然而，有些旅客在預訂後卻沒有入住，此時旅宿就會收取未入住罰款。由於這些交易涉及在旅客不在場的情況下對卡片進行扣款，因此可能受到《安全交易法》（SCA）規定的影響。

當交易受 PSD2 影響而收款手續卻不符規定，則可能會導致交易失敗，旅宿也可能會面臨信用卡公司的罰款。

Expedia Group 為了維持與旅宿的良好關係，並繼續服務我們的合作夥伴，因此提供給旅宿另一項合規辦法：受影響的網站現在可以利用 Expedia Group 來代為進行驗證。此舉有助於房產業者保障其業務，並確保 Rapid API 能持續提供同樣多元的房源選擇。

Rapid API 在旅宿內容檔案及旅宿內容中提供「<payment_registration_recommended=true>」標記，這有助於您在專案中識別可能涉及旅宿的情況。

整合可能產生的影響

若您欲提供需進行安全驗證的房源，則預訂流程應支援 3DS。若不支援 3DS，當「card-issuing」銀行判定該交易需要驗證時，預訂這些房源可能會失敗。

當旅宿, Rapid API 收取「no-show」費用時，該網站將成為記錄中的商家。帳單上的交易項目描述將由貴機構定義，而非旅宿。若想自訂此名稱，請聯絡 Rapid 合作夥伴服務。

為符合信用卡品牌的要求以及「Rapid API」上線流程，請使用 Accepted Payments API，在發生以下情況時於 check-out 頁面顯示processing_country：no-show. 凡是 Rapid API 擔任記錄商家的交易，皆須進行此步驟；若使用 3DS 且發生 no-show (交易失敗)，亦可能觸發此流程。

如何減輕對整合的影響

如果某個 Rapid API 整合服務在預訂流程中不支援安全驗證，則可透過不販售這些住宿來降低預訂失敗的風險。請聯絡 Rapid Partner Support，將受影響的旅宿收費率從您的 Availability API 回應中移除。

根據相關規定，使用代理工具時，該交易可免於適用《強式客戶認證》（SCA）規定。如有需要，可在「供應情況 API」的 sales_channel 欄位加註。

錯誤處理

「建立預訂 API」和「完成付款工作階段 API」可能會產生預訂確認和付款交易。

系統整合時請考慮以下說明，以避免財物損失和客戶操作的情形。