> ## Documentation Index
> Fetch the complete documentation index at: https://docs.localpayment.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 税款、账单和服务付款概览

在墨西哥支付法定税款、账单和服务费。本概述涵盖范围、支付流程和交易状态。

税款、账单和服务付款是 Localpayment 的一种付款方式（`paymentMethod.type: BillPay`），用于支付法定税款、账单和服务费。您不是将资金汇入受益人的银行账户，而是代表受益人将资金汇入政府或服务机构的账单参考编号。

本文面向需要以编程方式发放这些款项的集成商。内容涵盖范围、端到端支付流程和交易状态。有关 API 参考和代码示例，请参阅[发送税款、账单或服务付款](https://docs.localpayment.com/zh/docs/send-a-bill-payment.md)。

## 范围

| 字段 | 值 |
| - | - |
| **国家/地区** | 墨西哥（MEX） |
| **货币** | MXN |
| **操作类型** | 支付 |
| **付款方式** | 税款、账单和服务付款（账单支付，代码 0119） |
| **流程** | DIRECT |

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

***

## 开始之前

* 有效的[API 凭证](https://docs.localpayment.com/zh/docs/api-keys-and-environments.md)（访问令牌）。
* 一个专门用于缴纳税款和账单的账户。
* 针对您计划支付的税款或服务类型，已验证的 `billType` 目录（请参阅下方的[账单类型目录](#billtype-catalog)）。

***

## 支付流程

```mermaid theme={"theme":{"light":"github-light-high-contrast","dark":"github-dark-high-contrast"}}
%%{init: {'theme': 'base', 'themeVariables': {'primaryColor': '#31467c', 'primaryTextColor': '#ffffff', 'primaryBorderColor': '#0c1a29', 'actorBkg': '#31467c', 'actorBorder': '#0c1a29', 'actorTextColor': '#ffffff', 'actorLineColor': '#0c1a29', 'signalColor': '#0c1a29', 'signalTextColor': '#0c1a29', 'labelBoxBkgColor': '#31467c', 'labelBoxBorderColor': '#0c1a29', 'labelTextColor': '#ffffff', 'loopTextColor': '#0c1a29', 'noteBkgColor': '#ffffff', 'noteBorderColor': '#31467c', 'noteTextColor': '#0c1a29'}}}%%
sequenceDiagram
  autonumber
  participant Dev as 您的后端
  participant LP as Localpayment
  participant Fisco as 税务机关 / 账单方

  Dev->>LP: 提交账单支付（税种和账单编号）
  LP->>LP: 核对支付信息
  alt 需要审批
    LP-->>Dev: 支付正等待您的审批
    Dev->>LP: 批准该支付
  end
  LP->>Fisco: 发送支付
  Fisco-->>LP: 确认已收到支付
  LP-->>Dev: 通知您支付已完成
```

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

***

## 观看实际演示

下面的交互式演示展示了双向流程：最终用户在您的应用中看到的内容，以及 Localpayment 内部在后端收到 webhook 之前发生的情况。选择一个捕获行来模拟已完成或已拒绝的付款。这些值与[阶段测试目录](https://docs.localpayment.com/zh/docs/send-a-bill-payment.md#testing-in-stage)相匹配。

![Localpayment](https://docs.localpayment.com/images/brand/logo-localpayment.png)

终端用户支付体验

重置

![](https://docs.localpayment.com/images/flags/mexico.png)
墨西哥

您的应用：最终用户界面

your-app.example.com/payments/taxes

Localpayment：交易跟踪

***

## 交易状态

| 状态 | 类型 | 说明 |
| - | - | - |
| `PENDING` | 中间的 | 交易已收到，正在处理中。 |
| PENDING\_AUTH | 中间的 | requireAuth 已设置为 true。等待您调用授权 endpoint。 |
| IN\_PROGRESS | 中间的 | 交易正在由收款方处理。 |
| `COMPLETED` | 最终的 | 付款已成功处理。 |
| `FAILED` | 最终的 | 付款被拒绝。请检查响应中的错误数组。 |
| `EXPIRED` | 最终的 | 交易处理时间已超过限制。 |
| `REVERSED` | 最终的 | 款项已退回。 |

***

## 账单类型目录

`billType` 字段用于标识所支付的税费或服务。墨西哥适用的目录如下：

| 代码 | 说明 |
| - | - |
| 0098 | 联邦税 |

> [!WARNING]
>
> `billType` 目录会随着新增税种和服务类型而不断扩充。在正式启用新类型之前，请务必与您的 Localpayment 客户经理确认当前目录。

***

## 后续步骤

> [card] [发送税款、账单或服务付款](https://docs.localpayment.com/zh/docs/send-a-bill-payment.md)
>
> API 参考、请求和响应示例以及 webhook 通知。

> [card] [审批与双重签名](https://docs.localpayment.com/zh/docs/approvals-and-double-signature.md)
>
> 了解如何授权使用 requireAuth 创建的付款。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.