在墨西哥处理退款

在墨西哥，收款退还由专用接口端点处理：退回资金流动（POST /money_movements_return）。与哥伦比亚不同——在哥伦比亚，由于无法获取付款方详情，退款必须以全新出款的形式发起——在墨西哥，您只需引用要退还的贷记交易，Cobre 将处理其余所有操作。

这是因为 SPEI 贷记交易会保留付款方信息。当您调用退回 API 时，Cobre 将利用这些信息自动创建目标交易对手方和退回资金流动，将资金退还给原始付款方。您无需自行查询或注册付款方账户。

墨西哥的退回操作目前支持 SPEI 贷记交易（spei_credit）。

退回执行操作

墨西哥的退回操作以单一接口端点为核心。相关辅助操作如下：

操作	接口端点	用途
识别待退回的贷记交易	获取单笔交易 / 查询单个账户的交易记录	找到 `spei_credit` 交易及其 `transaction_id`。
退回贷记交易	退回资金流动	发起退回；Cobre 自动创建交易对手方和 `spei_return` 资金流动。
追踪结果	查询单笔资金流动	跟踪生成的 `spei_return` 资金流动至完成。

允许的退回组合

退回操作仅限于受支持账户服务商的 SPEI 贷记交易：

国家/地区	允许的交易类型	账户服务商 ID
墨西哥	`spei_credit`	`pr_mex_cobre3`
墨西哥	`spei_credit`	`pr_mex_072`（即将推出）
墨西哥	`spei_credit`	`pr_mex_014`（即将推出）
墨西哥	`spei_credit`	`pr_mex_012`（即将推出）

不支持在两个 pr_mex_cobre3 账户之间执行 spei_return 资金流动。

此类资金流动与账户关联功能不兼容。

快速上手

使用退回 API 前

Locate an eligible credit transaction

transaction_id 必须引用已记账至 Cobre Balance 或 Connect 账户的现有 spei_credit 交易，且需满足上述允许组合之一。借记交易退回或 SPEI 以外通道的贷记退回均会被拒绝。

Confirm the amount

退回操作将退还所引用贷记交易的全额。金额取自原始交易——无需在请求中指定。

Prepare a description

退回的 metadata.description 为必填项（1–40 个字符）。若支付通道支持，该说明将随退回操作传达至目标方。

退还 SPEI 贷记交易

第一步 — 找到贷记交易

检索您要退还的 spei_credit 交易。其 metadata 中包含付款方信息（sender_name、sender_id、sender_account_number、tracking_key），Cobre 将使用这些信息路由退回操作——您无需提取或传递这些信息。

{
  "id": "trx_1232145215",
  "type": "spei_credit",
  "amount": 5000,
  "currency": "mxn",
  "credit_debit_type": "credit",
  "metadata": {
    "sender_name": "Fernando Alonso",
    "sender_id": "XEXX010101000",
    "sender_account_number": "1000100010001000",
    "tracking_key": "20240719CCbbbb6AAAAAA",
    "account_reference": "703011052301000014"
  }
}

第二步 — 调用退回 API

发送 transaction_id 和退回的 metadata.description。请求中无需提供交易对手方、金额、来源或目标——Cobre 将从原始交易中推导这些信息。

{
  "transaction_id": "trx_1232145215",
  "metadata": {
    "description": "Returned transaction"
  }
}

transaction_id 和 metadata（及其必填的 description）均为必填项。

第三步 — 查看响应

成功调用将返回 type: spei_return、geo: mex、currency: mxn、status.state: initiated 的资金流动。external_id 会回传您提交的 transaction_id，确保与原始贷记交易的关联自动保留。

{
  "id": "mm_123456789012",
  "external_id": "trx_1232145215",
  "creator": "usr_bGcdf26rR4",
  "type": "spei_return",
  "geo": "mex",
  "status": {
    "state": "initiated",
    "code": "",
    "description": ""
  },
  "source_id": "acc_KJnAkypWSc",
  "destination_id": "cp_012345678910",
  "currency": "mxn",
  "amount": 5000,
  "metadata": {
    "description": "Returned Transaction",
    "tracking_key": "20240624mmbgu7gkQwofrb9o",
    "reference": "0123456",
    "cep_url": ""
  },
  "created_at": "2024-06-24T15:37:37Z",
  "updated_at": "2024-06-24T15:37:38Z",
  "checker_approval": false
}

关于退回操作，请注意：

destination_id 引用 Cobre 自动创建的交易对手方，类型为 mm_return。

external_id 始终包含用于发起退回的 transaction_id。

响应 metadata 中的 reference 包含退回创建日期，格式为 YYYYMMDD。

batch_id、mm_approval_id 保持为空，checker_approval 保持为 false——退回不经过审批流程。

发送退回后的预期结果

系统创建一条新的 spei_return 资金流动。 该资金流动代表资金返还给原始付款方，可像任何其他资金流动一样进行追踪，包括通过通知与订阅。

系统创建一个新的交易对手方。 Cobre 自动注册一个类型为 mm_return 的交易对手方作为退回目标；无需您自行管理。

系统记录一笔 spei_debit 交易。 退回结算后，原始 Cobre Balance 或 Connect 账户将出现一笔 spei_debit，与原始贷记相抵。相应的 spei_return 交易记录通过其 money_movement_id 和 tracking_key 关联回原始贷记。

通过 external_id 进行对账。 由于响应的 external_id 等于原始 transaction_id，您可以在账本和报告中直接将退回与其来源贷记进行匹配。

追踪最终状态。 spei_return 资金流动使用与其他本地资金流动相同的状态生命周期：initiated → processing → completed（或 rejected/failed，这些状态会携带 code 和 description）。不存在 returned 状态。

在墨西哥处理退款

退回执行操作#

允许的退回组合#

快速上手#

使用退回 API 前#

退还 SPEI 贷记交易#

第一步 — 找到贷记交易#

第二步 — 调用退回 API#

第三步 — 查看响应#

发送退回后的预期结果#