设置第三方付款网关

配置第三方付款网关的初始设置

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 是站点端点和付款网关提供商 ID 的组合。通过在第三方付款网关的标准通知传输设置中提供 URL，创建 Webhook。

1. 将此 URL 用于站点的端点，用站点的域和 URL 替换 MyDomainName。例如：
   https://MyDomainName.my.salesforce-sites.com/solutions/services/data/v65.0/commerce/payments/notify
2. 查找付款网关提供商的 ID，并将?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 组织，付款网关配置选项卡默认不可用。要解决此问题，将付款网关配置选项卡的设置更改为默认打开。

3. 填写这些字段，以创建付款网关提供商。
   1. 输入付款网关提供商的唯一名称和标签。
   2. 从下拉列表中选择 Apex 适配器类。
   3. 指定对 idempotency 所需的支持。有关更多详细信息，请查看幂等指南。
   4. 保存付款网关提供商详细信息。
4. 填写这些字段以添加付款网关。
   1. 输入付款网关的唯一名称。
   2. 从下拉列表中选择付款网关提供商。
   3. 从下拉列表中选择命名凭据。
   4. 将付款网关的状态标记为已启用。
   5. 保存付款网关详细信息。

   如果您已有付款网关提供商，请在指导设置中选择步骤 7：付款配置，展开配置第三方付款网关步骤，然后单击配置付款网关。在“付款网关配置”页面上，单击付款网关，然后单击新建。配置步骤相同。

添加多种付款方式

在第三方付款网关上配置对付款方式的支持，例如自动清算所 (ACH)、单欧元付款区 (SEPA)、银行家的自动清算服务 (BACS) 和批量电子清算系统 (BECS)。您可以在账单简档的“已保存付款方式”选项卡中处理付款、发放退款并查看这些保存的付款方式。

• 要添加银行付款方式，例如 ACH、SEPA、BACS 和 BECS，请使用 tokenizePaymentMethod API，并将bankPaymentMethod对象中的 bankType 属性设置为您选择的银行付款方式。
• 要添加信用卡或借记卡等卡付款方式，请使用 tokenizePaymentMethod API，并在cardPaymentMethod对象中设置cardCategory属性。