跳转到主要内容
在墨西哥支付法定税款、账单和服务费。本概述涵盖范围、支付流程和交易状态。 税款、账单和服务付款是 Localpayment 的一种付款方式(paymentMethod.type: BillPay),用于支付法定税款、账单和服务费。您不是将资金汇入受益人的银行账户,而是代表受益人将资金汇入政府或服务机构的账单参考编号。 本文面向需要以编程方式发放这些款项的集成商。内容涵盖范围、端到端支付流程和交易状态。有关 API 参考和代码示例,请参阅发送税款、账单或服务付款。

范围

Localpayment 不会验证所声明的 amount 是否与账单参考编号中编码的金额一致。在提交请求之前,您的集成负责声明正确的金额。

开始之前

  • 有效的API 凭证(访问令牌)。
  • 一个专门用于缴纳税款和账单的账户。
  • 针对您计划支付的税款或服务类型,已验证的 billType 目录(请参阅下方的账单类型目录)。

支付流程

  1. 您向 POST /api/payout/ 发送请求,将 paymentMethod.type 设置为 BillPay,并在 beneficiary 对象中包含 billType 和 billReference。
  2. Localpayment 会验证必填字段和 billType 目录。
  3. 如果 requireAuth 为 true,交易将保持在 PendingAuth 状态,直到您调用授权 endpoint。
  4. Localpayment负责与税务机关或收款方进行付款处理。
  5. Localpayment 会更新交易状态并通过 webhook 通知您。

观看实际演示

下面的交互式演示展示了双向流程:最终用户在您的应用中看到的内容,以及 Localpayment 内部在后端收到 webhook 之前发生的情况。选择一个捕获行来模拟已完成或已拒绝的付款。这些值与阶段测试目录相匹配。

交易状态


账单类型目录

billType 字段用于标识所支付的税费或服务。墨西哥适用的目录如下:
billType 目录会随着新增税种和服务类型而不断扩充。在正式启用新类型之前,请务必与您的 Localpayment 客户经理确认当前目录。

后续步骤

发送税款、账单或服务付款

API 参考、请求和响应示例以及 webhook 通知。

审批与双重签名

了解如何授权使用 requireAuth 创建的付款。
最后修改于 2026年11月10日