[TITLE]
如何在 Odoo 中使用 Stripe 创建和配置支付账户

[DESCRIPTION]
本文详细介绍了在 Odoo（包括 Odoo Online、Odoo.sh 与本地部署）中创建 Stripe 账户、手动输入凭证、配置 Webhook、启用 Apple Pay 等完整步骤，并提供开发者模式、测试模式及多公司共享凭证的实用技巧，帮助企业快速集成 Stripe 支付解决方案。

[KEYWORDS]
Stripe, Odoo, 支付提供商, 创建账户, 手动凭证输入, Apple Pay, Webhook, 开发者模式, 测试模式, 多公司

Stripe

Stripe 是一家总部位于美国的在线支付解决方案提供商，帮助企业接受 信用卡 等多种支付方式。

::: seealso

要创建新的 Stripe 账户并将其关联到 Odoo 数据库，请确保公司 Email 已在 公司设置 <general/companies/company> 中配置完毕，然后根据你的托管类型按以下步骤操作：

:::: tabs
.. group-tab:: Odoo Online

  1. 导航至支付提供商 Stripe <payment_providers/supported_providers> 并点击 连接 Stripe。
  2. 完成设置流程，并在 Stripe 发送确认邮件后确认你的电子邮件地址。
  3. 流程结束时点击 同意并提交。如果所有必填信息已提交，你将被重定向回 Odoo，支付提供商即被启用。

::: group-tab
Odoo.sh 或本地部署
:::

  1. 导航至支付提供商 Stripe <payment_providers/supported_providers> 并点击 连接 Stripe。
  2. 完成设置流程，并在 Stripe 发送确认邮件后确认你的电子邮件地址。
  3. 流程结束时点击 同意并提交；随后你会被重定向到 Odoo 中的 Stripe 支付提供商页面。
  4. 填写你的凭证 <payment_providers/stripe/manual_input>。
  5. 将 状态 字段设为 已启用。
    ::::

:::: tip
::: title
提示
::

如果你是 创建 了一个账户而非 关联已有账户 <payment_providers/stripe/manual_input>，请先 启用开发者模式 <developer-mode>，然后在 Stripe 支付提供商表单上点击 重置你的 Stripe 账户，随后 填写你的 Stripe 账户凭证 <payment_providers/stripe/manual_input>。
::::

在以下情形下需要手动输入凭证：将已有 Stripe 账户关联到 Odoo 数据库、在 Odoo.sh 或本地部署时创建账户、或在 不影响真实交易 的情况下测试 Stripe <payment_providers/test-mode>。

  1. 前往 Stripe 的 API 密钥页面，或登录 Stripe 仪表盘后进入 开发者 --> API 密钥。
  2. 在 标准密钥 区域，复制 Publishable key（可发布密钥）和 Secret key（私密密钥），并保存以备后续 payment_providers/stripe/odoo-configuration 使用。
  1. 启用开发者模式 <developer-mode>。
  2. 导航至 Stripe 支付提供商 <payment_providers/supported_providers>。
  3. 在 凭证 标签页中，填写之前保存的 Publishable Key（可发布密钥）和 Secret Key（私密密钥）。
  4. 点击 生成你的 Webhook。
  5. 根据需要配置其余选项。
  6. 将 状态 字段设为 已启用。

:::: tip
::: title
提示
::

  • 也可以使用 测试模式 <payment_providers/test-mode> 以及你 Stripe 账户的测试 API 密钥 <payment_providers/stripe/stripe-configuration> 来进行不影响真实交易的测试，详见 Stripe 测试用例文档。
  • 若需将同一 Stripe 账户关联到数据库中的 多个公司 </applications/general/companies/multi_company>，先为其中一家 创建账户 <payment_providers/stripe/create_account> 并 手动输入凭证 <payment_providers/stripe/manual_input>，随后在其他公司复用相同的凭证和 Webhook。要查看 Webhook，可前往 Stripe 的 Webhook 页面 或在仪表盘中进入 开发者 --> Webhooks，点击列表中的目标，再点击 fa-eye（显示密钥）图标，复制 Signing secret（签名密钥）值。
    ::::

若希望客户在电商订单中使用 Apple Pay 按钮支付，导航至 Stripe 支付提供商 <payment_providers/supported_providers>，进入 配置 标签页，勾选 允许快速结账，并点击 启用 Apple Pay。

::: seealso
快速结账与 Google Pay <payment_providers/express_checkout>
:::

:::: tip
::: title
提示
::

Stripe 还支持在 Odoo 或直接在 Stripe 仪表盘中 手动捕获 <payment_providers/manual_capture> 与 退款 <payment_providers/refunds> 支付。
::::

[SUMMARY]

  • Stripe 在 Odoo 中的使用
    • 创建 Stripe 账户
      • Odoo Online
      • Odoo.sh / 本地部署
    • 手动输入凭证
      • Stripe 配置
      • Odoo 配置
    • 启用 Apple Pay
    • 提示与技巧
      • 开发者模式与重置账户
      • 测试模式使用
      • 多公司共享凭证与 Webhook
      • 手动捕获与退款