[TITLE]
Mercado Pago 支付终端在 Odoo POS 的配置与使用指南

[DESCRIPTION]
本文详细介绍了在 Odoo POS 中使用 Mercado Pago 支付终端的完整配置步骤，包括创建 Mercado Pago 账户、终端与门店关联、Point Smart 应用设置、凭证生成以及在 Odoo 中创建支付方式的操作指南，并提供注意事项和常见警告。

[KEYWORDS]
Mercado Pago, 支付终端, Odoo POS, Point Smart, 账户配置, 凭证生成, 在线支付, 终端连接, 支付方式, 警告

[TRANSLATED_CONTENT]

Mercado Pago

Mercado Pago 提供通过
payment terminals <../terminals>
处理客户交易的支付解决方案。

:::: important
::: title
重要
:::

  • Odoo 兼容 Point Smart 1 或 Point Smart 2 支付终端，可在 Mercado Pago 官网购买，覆盖 阿根廷、巴西 和 墨西哥。
  • Mercado Pago 支付终端无需 IoT Box </applications/general/iot> 即可运行。
    ::::

::: seealso

配置 Mercado Pago 需要创建账户（如有必要），并将其 连接到支付终端和门店 <pos/mercado-pago/terminal>。随后，创建一个 Point Smart 应用 <pos/mercado-pago/point-smart> 进行技术设置，并获取 凭证 <pos/mercado-pago/credentials> 完成集成。

  1. 如有需要，创建 Mercado Pago 账户：
  2. 打开 Point Smart 终端，按照屏幕指示操作，直至出现将终端与 Mercado Pago 账户关联的提示。
  3. 点击 Soy responsable del negocio 以获取配对二维码。
  4. 使用移动设备登录你的 Mercado Pago 账户。
  5. 用移动设备扫描二维码，完成账户关联。
  6. 确认终端已正确关联到门店：
    1. 输入 Mercado Pago 账户的电子邮件或手机号，点击 Continuar。
    2. 在弹窗中再次点击 Continuar。
    3. 在 Configura el lector para tu cuenta [account name] 页面，点击 Empezar configuración。
    4. 点击 Crear nueva sucursal 添加新门店。
    5. 输入门店名称和地址，必要时补充其他信息，点击 Crear sucursal。
    6. 输入收银机名称，点击 Confirmar sucursal y caja。
    7. 点击 Crear clave 创建安全密钥，保护门店。
  1. 登录 Mercado Pago 开发者平台。
  2. 点击 Tus integraciones，随后点击 Crear aplicación。
  3. 在 Configuraciones básicas 区域，填写应用名称，选择 Pagos presencial 与 PointdeMercadoPago，然后点击 Crear aplicación，获取应用编号。

在 Mercado Pago 开发者仪表盘 中需要生成并收集三项凭证：Webhook 密钥、访问令牌（Access Token）以及 终端序列号。

  1. 生成 Webhook 密钥：
    1. 在 Notificaciones 下的 Webhooks 中，选择 Modo productivo。
    2. 粘贴你的 Odoo 数据库 URL，后接 /pos_mercado_pago/notification（例如 https://mycompany.odoo.com/pos_mercado_pago/notification）。
    3. 复制生成的 Webhook 密钥并保存，以备后续 pos/mercado-pago/payment-method 步骤使用。
  2. 生成访问令牌：
    1. 在 Producción 区域点击 Credenciales de producción，随后点击 Activar credenciales de producción。
    2. 复制生成的访问令牌并保存，同样用于 pos/mercado-pago/payment-method。
  3. 在终端背面查找 终端序列号，记录下来以供 pos/mercado-pago/payment-method 使用。

完成 Mercado Pago 配置后，登录 Odoo 数据库，使用收集到的凭证创建一个 支付方式 <pos/mercado-pago/payment-method>。

:::: warning
::: title
警告
:::

Odoo 不支持 Standalone（独立）运行模式。
::::

:::: note
::: title
备注
:::

所有通过 Mercado Pago 账户购买的终端会自动显示在 Mercado Pago 仪表盘中。
::::

  1. 前往 Point of Sale --> Configuration --> Settings，向下滚动至 Payment Terminals 区域，勾选 Mercado Pago，然后点击 Save。
  2. 前往 Point of Sale --> Configuration --> Payment Methods，创建相应的支付方式 <../../payment_methods>。
  3. 使用 之前生成的凭证 <pos/mercado-pago/configuration> 填写必填字段：
    • 将访问令牌粘贴到 Production user token（生产用户令牌）字段。
    • 将 Webhook 密钥粘贴到 Production secret key（生产密钥）字段。
    • 将终端序列号填写在 Terminal S/N（终端序列号）字段。
  4. 保存支付方式。

:::: note
::: title
备注
:::

在终端上的操作应触发 Odoo POS 界面的通知。如未出现，请确保 Webhook 密钥正确。
::::

[SUMMARY]

  • Mercado Pago
    • 支付终端概述
    • 兼容终端：Point Smart 1 / 2（阿根廷、巴西、墨西哥）
    • 不需要 IoT Box
  • 配置步骤
    • 创建账户并关联终端与门店
      • 注册账户（墨西哥、阿根廷、巴西）
      • 打开终端并配对 QR 码
      • 在账户中添加分店和收银机
    • 创建 Point Smart 应用
      • 登录开发者平台
      • 新建应用，选择“现场支付”
    • 生成凭证
      • Webhook 密钥
      • Access token（访问令牌）
      • 终端序列号
  • Odoo POS 配置
    • 启用 Mercado Pago 支付终端
    • 创建支付方式并填入凭证
    • 注意事项
      • 不支持 Standalone 模式
      • 终端自动显示在仪表盘
      • 确保 Webhook 密钥正确