付款 · 墨西哥
在您已在使用的平台上，完成墨西哥税费、账单与服务缴费。
在您已在使用的同一平台上缴纳联邦税，使用对应的缴款参考号，并通过 webhook 通知跟踪每笔付款的状态。
- 墨西哥 · MXN
- 联邦税
- Webhook 通知
墨西哥 · MXN- 09:41:02.11409:41:02PayIn100 INPROGRESS20084 ms
- 09:41:05.90209:41:05PayIn200 COMPLETED20091 ms
- 09:42:18.33009:42:18PayOut100 INPROGRESS20077 ms
- 09:42:40.01809:42:40PayOut200 COMPLETED20088 ms
- 09:43:00.55109:43:00VirtualAccount200 COMPLETED20080 ms
POST https://example-merchant.com/webhooks/localpayment
x-Signature: HMAC-SHA256 3f9a1c0e…b47e2b
{ "transactionType": "PayIn", "transactionFlow": "DIRECT",
"data": { "externalId": "order_8F2K-1043",
"status": { "code": "200", "description": "COMPLETED" } } }核心优势
简化您在墨西哥的税费缴纳运营
税费、账单与服务缴费是一种付款方式：资金不是汇入银行账户，而是代受益人缴付政府或服务机构的缴款参考号。
在同一平台缴纳联邦税
一笔税费缴纳就是您已在使用的 Localpayment API 上的又一笔付款（BillPay，代码 0119）。
凭缴款参考号付款
发送税种和对应的缴款参考号；在墨西哥即 SAT 缴款参考号。
覆盖墨西哥（MEX / MXN）
面向在墨西哥运营的客户，以墨西哥比索付款。
通过 webhook 跟踪状态
您的后端通过 webhook 通知接收每笔付款的最终状态。
运作方式
从缴款参考号到完成付款
- 01
提交付款
调用 POST /api/payout/，paymentMethod.type 设为 BillPay，并在 beneficiary 对象中填写 billType 和 billReference。
- 02
校验
Localpayment 校验必填字段和 billType 目录。
- 03
审批（可选）
若 requireAuth 为 true，付款将停留在 PENDING_AUTH，直到您调用授权端点。
- 04
付款
Localpayment 与税务机关或收费方处理该笔付款。
- 05
Webhook
Localpayment 更新交易状态，并通过 webhook 通知您。
交易状态
每种付款状态，定义清晰
PENDING
- 类型
- 中间状态
- 说明
- 交易已接收，正在处理。
PENDING_AUTH
- 类型
- 中间状态
- 说明
- requireAuth 为 true：等待您调用授权端点。
IN_PROGRESS
- 类型
- 中间状态
- 说明
- 收费方正在处理该交易。
COMPLETED
- 类型
- 最终状态
- 说明
- 付款已成功处理。
FAILED
- 类型
- 最终状态
- 说明
- 付款被拒绝；响应中的 errors 数组会说明原因。
EXPIRED
- 类型
- 最终状态
- 说明
- 交易超过了处理时限。
REVERSED
- 类型
- 最终状态
- 说明
- 付款已被冲正。
Localpayment 不校验申报金额是否与参考号中编码的金额一致：正确金额由您的集成申报。
面向开发者
税费缴纳就是一笔带参考号的付款
使用 Create a Payout 端点，paymentMethod.type 设为 BillPay。beneficiary 对象中不填银行账户，而是填写税种和官方参考号。
- paymentMethod.type BillPay，代码 0119，流程 DIRECT
- beneficiary.billType 0098：联邦税
- beneficiary.billReference：20 位 SAT 缴款参考号
# Stage 环境示例请求——完整接口说明见 docs.localpayment.com
curl --request POST \
--url https://api.stage.localpayment.com/api/payout/ \
--header 'Authorization: Bearer <your_access_token>' \
--header 'Content-Type: application/json' \
--data '{
"externalId": "550e8400-e29b-41d4-a716-446655440000",
"country": "MEX",
"currency": "MXN",
"amount": 100.00,
"accountNumber": "<your_account_number>",
"paymentMethod": { "type": "BillPay", "code": "0119", "flow": "DIRECT" },
"beneficiary": { "billType": "0098", "billReference": "20260713000000000001" },
"sender": { "type": "INDIVIDUAL", "name": "Jane", "lastName": "Doe" },
"merchant": { "type": "COMPANY", "name": "Merchant Name" }
}'常见问题
在哪些地区可用？
墨西哥（MEX），以墨西哥比索（MXN）付款。它以付款（payout）方式运行：Localpayment 代受益人将资金缴付至政府或服务机构的缴款参考号。
目前可以缴纳哪些税？
墨西哥的 billType 目录涵盖联邦税（billType 0098）。目录会随新的税种和服务类型增加而扩充；上线新类型前，请与您的客户经理确认。
开始前需要准备什么？
API 凭证、一个为税费和账单缴纳注资的专用账户、您计划缴纳的 billType，以及纳税人或收费方提供的缴款参考号（在墨西哥即 SAT 缴款参考号）。
如何跟踪每笔付款？
Localpayment 通过 webhook 向您的端点通知最终状态，包含 externalId、billType 和 billReference。投递失败时最多以指数退避重试 3 次，您也可以随时通过 API 查询交易。
Localpayment 会核对金额吗？
不会。由您的集成申报参考号中编码的金额，并确认该参考号尚未缴付，因为已缴付的参考号不能重复使用。过期的 SAT 参考号在经 SAT 校验后会被拒绝。