設定協力廠商付款 Gateways

設定協力廠商付款的初始設定

1. 在您要實作的第三方付款管道中建立電子商務商家帳戶。
   1. 登入您的第三方付款通道提供者,並新增電子商務商家帳戶。
   2. 瀏覽至您所選付款管道平台的金鑰管理、開發人員或進階設定區段,並產生 API 金鑰或機密金鑰。

      您的 API 金鑰如下所示: AQEvhmfxJ43HaxxHw0m/n3Q5qf3Ve4pBCIBMV3dVwyD4zesmTx/rk8/RZRz2w0bDdqMQwV1bDb7kfNy1WIxIIkxgBw==-C5bPe6tPCqOM35AEGroDa54J1Bl9AnsQKrDsDofVlrk=-i1ibf$Hu2v>8jR:Y9nU。

   3. 記下商家帳戶使用者名稱與 API 金鑰。您需要這些使用者才能建立已命名認證。
2. 在您的 Salesforce 組織中建立付款管道 Apex 類別。
   1. 從付款管道提供者或 AppExchange 取得轉接器類別詳細資料。
      若要建立與設定付款門戶轉接器,請參閱 付款門戶轉接器。若要定義您的 Apex 類別,請參閱 商務付款命名空間。
   2. 儲存您的 Apex 類別。請記下您用來建立付款管道提供者的轉接器名稱。
3. 在 Salesforce 組織中建立舊版已命名認證,以指定驗證參數和 Apex 呼叫端點的 URL。
   1. 指定標籤的使用者易用名稱,以及名稱的唯一識別碼。
   2. 輸入您協力廠商付款管道的 URL。
   3. 選取「已命名主體」作為身分類型,並選取「密碼驗證」作為驗證通訊協定。
   4. 使用您的商家帳戶使用者名稱作為使用者名稱。根據付款管道提供者要求,使用 API 金鑰作為密碼。
   5. 依您用來建立付款門戶所需儲存已命名認證。
4. 在您的 Salesforce 組織中註冊您的第三方付款門戶網站,以確保從組織到付款門戶網站的 Apex 呼叫成功。
   1. 輸入您第三方付款管道的名稱和 URL。
   2. 將網站標記為已啟用,然後儲存您的變更。
5. 在您的 Salesforce 組織中新增您的第三方付款門戶 URL 作為信任 URL。
   1. 輸入 API 名稱。
   2. 輸入您協力廠商付款管道的 URL。
   3. 將 URL 標記為啟用,然後儲存您的變更。
6. 啟用並設定您的 Salesforce 網站,以便您可以從第三方門戶傳送和接收付款通知。
   1. 輸入網站的標籤、名稱和首頁。
   2. 將網站的公用存取設定設定為「付款 API 的來賓存取權」。
   3. 儲存您的網站詳細資料。

在您的第三方付款門口上設定通知設定

付款管道使用 Webhook 將通知傳送至您的付款管道轉接器。Webhook 是您網站端點與付款門戶提供者識別碼的組合。透過在第三方付款管道的標準通知傳輸設定中提供 URL 來建立 Webhook。

1. 將此 URL 用於您網站的端點,以您網站的網域和 URL 取代 MyDomainName。例如：
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. 尋找付款門戶提供者的識別碼,然後將 ?provider=ID 查詢參數附加至端點。例如,https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify?provider=0cJR00000004CEhMAM
3. 在第三方付款的標準通知設定中輸入 Webhook。

設定付款門戶提供者和付款門戶

設定商家帳戶、轉接器類別和 Salesforce 網站後,請新增付款通道提供者。接著,在付款門戶提供者上新增付款門門。

1. 進入「設定」,在「快速尋找」方塊中輸入「帳單」,然後選取「引導式設定」中的「步驟 7:付款組態」。
2. 展開「 設定第三方付款門戶 」步驟,按一下「 設定付款門戶」,然後按一下「 設定」。
   

   備註

   針對在 Winter ’26 中建立的 Salesforce 組織,依預設可使用「帳單引導式設定」中的「步驟 7:付款組態」按鈕,該按鈕會將使用者重新導向至「付款門戶組態」索引標籤。針對在 Winter ’26 版之前建立的 Salesforce 組織,依預設無法使用「Payment Gateway 組態」索引標籤。若要修正此問題,請將「付款門戶組態」索引標籤的設定 變更為「預設開啟」。

3. 完成這些欄位以建立付款管道提供者。
   1. 輸入付款管道提供者的唯一名稱和標籤。
   2. 從下拉式清單中選取 Apex 轉接器類別。
   3. 指定您所需的 idempotency 支援。如需詳細資料,請參閱 Idempotency Guidelines。
   4. 儲存付款管道提供者詳細資料。
4. 完成下列欄位以新增付款管道。
   1. 輸入付款的唯一名稱。
   2. 從下拉式清單中選取付款管道提供者。
   3. 從下拉式清單中選取已命名認證。
   4. 將您的付款管道狀態標記為「啟用」。
   5. 儲存付款管道詳細資料。

   如果您已有現有的付款通道提供者,請在「引導式設定」中選取「步驟 7:付款組態」,展開「設定第三方付款通道」步驟,然後按一下「設定付款通道」。在「付款門戶組態」頁面上,按一下「付款門戶」,然後按一下「新增」。組態步驟相同。

新增多個付款方式

在您的第三方付款管道上設定付款方式的支援,例如自動結算中心 (ACH)、單一歐元付款區域 (SEPA)、銀行業者自動結算服務 (BACS) 和大量電子結算系統 (BECS)。您可以在帳單設定檔的「已儲存付款方式」索引標籤中處理付款、發出退款,以及檢視這些已儲存的付款方式。

• 若要新增如 ACH、SEPA、BACS 和 BECS 等銀行付款方式,請使用 tokenizePaymentMethod API,並將 bankPaymentMethod 物件中的 bankType 內容設定為您所選的銀行付款方式。
• 若要新增信用卡或簽帳卡等卡片付款方式,請使用 tokenizePaymentMethod API,並在 cardPaymentMethod 物件中設定 cardCategory 內容。