账单与税费缴纳 · 墨西哥
一套 API，在墨西哥按参考号缴纳联邦税。
BillPay 通过您已在使用的付款 API 缴纳政府缴费单。目前已在墨西哥上线，以 MXN 向 SAT 缴纳联邦税。
- 墨西哥 · MXN
- SAT 联邦税
- 可选双重签名
墨西哥 · MXN- 墨西哥，以墨西哥比索缴纳
- MXN
- 联邦税，billType 0098
- SAT
- 付款发出前的审批步骤
- 可选
- 每次状态变更都会通知
- Webhook
为什么选择 BillPay
在您的产品内完成税款缴纳
客户无需离开您的平台去缴纳 SAT 税款。BillPay 把一张税款缴费单变成一笔普通付款。
一次集成
BillPay 是一种付款方式（type BillPay，代码 0119）。如果您已接入付款，大部分集成工作已经完成。
按参考号缴费
提交缴费类型、缴费参考号和金额，Localpayment 代您的客户完成缴纳。
可选审批
添加 requireAuth，需第二位授权用户确认后才会付款。
状态清晰
七种文档化状态，从 PENDING 到 COMPLETED、FAILED、EXPIRED 或 REVERSED。
从专用账户支付
从为税款和账单缴纳注资的专用 Localpayment 账户中扣款。
统一对账
缴费记录出现在与其他业务相同的报表、账户流水和 webhook 中。
工作流程
四步完成，从缴费单到缴纳成功
- 01
提交参考号
调用 POST /api/payout/，类型为 BillPay（代码 0119），billType 0098，并附上 SAT billReference 和金额。
- 02
校验
Localpayment 检查请求并以您的 externalId 受理。金额以您的集成申报为准。
- 03
审批（可选）
启用 requireAuth 时，第二位用户需在 Business Portal 或通过 API 批准后才会发出。
- 04
缴纳成功 + webhook
参考号缴纳成功后，签名 webhook 会通知 COMPLETED，便于与其他付款一起对账。
状态
每种交易状态，定义清晰
每笔缴费都会通过 webhook 和交易状态 API 报告七种状态之一。
待处理 (PENDING)
- 含义
- 已受理，等待处理。
待授权 (PENDING_AUTH)
- 含义
- 等待第二位审批人（requireAuth）。
处理中 (IN_PROGRESS)
- 含义
- 正在缴纳该参考号。
已完成 (COMPLETED)
- 含义
- 该参考号已缴纳成功。
失败 (FAILED)
- 含义
- 缴纳未能完成，响应中会说明原因。
已过期 (EXPIRED)
- 含义
- 缴纳超出了处理时限。
已冲正 (REVERSED)
- 含义
- 已处理的缴费被冲正。
金额由您的集成申报；Localpayment 不会根据参考号核验金额。 以上为概要说明。准确定义和错误代码请参阅文档中的 BillPay 指南。
适用对象
为服务墨西哥企业的平台而设计
把联邦税缴纳嵌入客户日常管理资金的地方，免去他们离开您的产品去缴费的步骤。
- 财务、薪资和 ERP 软件：在产品内直接缴纳联邦税
- 金融科技与企业钱包：让用户用账户余额缴纳 SAT 税款
- 企业服务商：为您管理的公司自动化缴税
概览
USD
1,284,560.00
+4.2%
BRL
3,420,118.40
+12.8%
MXN
8,905,332.10
+6.1%
- 收款 · Pixorder_8F2K-1043+ R$ 1,250.00
- 付款 · SPEIseller_0921− MX$ 18,400.00
- 换汇 · BRL → USDfx_3b7q250,000.00 USD
- 收款 · Bre-Border_9A1C-2210+ COP 890,000
开发者
缴税就是一笔带参考号的付款
使用 Create Payout 接口，选择 BillPay 方式并填写受益人的缴费信息。使用 Bearer 令牌认证，并通过签名 webhook 接收结果。
- paymentMethod.type 为 BillPay，代码 0119
- beneficiary.billType 0098（联邦税，SAT）和 billReference
- 可选 requireAuth，实现第二人审批
# 示例请求——具体接口规范请以 docs.localpayment.com 为准
curl -X POST https://api.stage.localpayment.com/api/payout/ \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"externalId": "9a7e5c3b-0000-4000-8000-000000000119",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"country": "MEX",
"currency": "MXN",
"amount": 12500.00,
"accountNumber": "<your-account-number>",
"requireAuth": true,
"beneficiary": { "billType": "0098", "billReference": "0426ABCD12345678901X" },
"sender": { "type": "COMPANY", "name": "Nortia Commerce S.A. de C.V." },
"merchant": { "type": "COMPANY", "name": "<your-company-name>" }
}'常见问题
BillPay 在哪些国家可用？
BillPay 目前在墨西哥可用，币种为 MXN。如需在其他市场缴纳账单或税款，请与我们的团队沟通您的使用场景。
可以缴纳哪些费用？
目前 billType 目录涵盖向 SAT 缴纳的联邦税（billType 0098）。
需要提交哪些信息？
缴费类型、参考号和金额，以及付款的标准字段，例如您的 externalId 和账户号。
需要单独集成吗？
不需要。BillPay 是付款 API 的一种支付方式，与其他付款共用认证、状态、webhook 和报表。
可以增加审批环节吗？
可以。设置 requireAuth 后，缴费将保持 PENDING_AUTH 状态，直到第二位授权用户批准。
如何确认缴费成功？
状态变化时您会收到签名 webhook，也可以随时凭 externalId 查询交易状态 API。
税款以哪种货币支付？
以墨西哥比索（MXN）支付，从您在墨西哥为税款和账单缴纳注资的 Localpayment 账户扣款。可用本地收款或 Wire In 注资，必要时通过换汇从硬通货转换。
有金额限制吗？
最低金额为 MXN 0.01，无最高限额。您发送的金额必须与缴费参考号中的金额一致。