Payouts · Mexico
Tax, Bill and Service Payments in Mexico, from the platform you already use.
Pay federal taxes from the same platform you already use, with the corresponding payment reference, and track every payment status through webhook notifications.
- Mexico · MXN
- Federal taxes
- Webhook notifications
Mexico · 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" } } }Key benefits
Simplify your tax payment operations in Mexico
Tax, Bill and Service Payments is a payout method: instead of sending funds to a bank account, you pay a government or service billing reference on the beneficiary’s behalf.
Pay federal taxes from the same platform
A tax payment is one more payout (BillPay, code 0119) on the Localpayment API you already use.
Pay with the payment reference
Send the tax type and the corresponding payment reference; for Mexico, the SAT payment reference.
Available in Mexico (MEX / MXN)
For customers operating in Mexico, with payments in Mexican pesos.
Track status by webhook
Your backend receives the final status of every payment through webhook notifications.
How it works
From payment reference to completed payment
- 01
Send the payment
Call POST /api/payout/ with paymentMethod.type BillPay, plus billType and billReference in the beneficiary object.
- 02
Validation
Localpayment validates the required fields and the billType catalog.
- 03
Approval (optional)
With requireAuth set to true, the payment waits in PENDING_AUTH until you call the authorization endpoint.
- 04
Payment
Localpayment processes the payment with the tax authority or biller.
- 05
Webhook
Localpayment updates the transaction status and notifies you by webhook.
Transaction states
Every payment status, clearly defined
PENDING
- Type
- Intermediate
- Description
- The transaction was received and is being processed.
PENDING_AUTH
- Type
- Intermediate
- Description
- requireAuth was true: waiting for you to call the authorization endpoint.
IN_PROGRESS
- Type
- Intermediate
- Description
- The transaction is being processed by the biller.
COMPLETED
- Type
- Final
- Description
- The payment was processed successfully.
FAILED
- Type
- Final
- Description
- The payment was rejected; the errors array in the response explains why.
EXPIRED
- Type
- Final
- Description
- The transaction exceeded the processing time limit.
REVERSED
- Type
- Final
- Description
- The payment was reversed.
Localpayment does not validate that the declared amount matches the amount encoded in the bill reference: your integration declares the correct amount.
For developers
A tax payment is a payout with a bill reference
Use the Create a Payout endpoint with paymentMethod.type BillPay. Instead of a bank account, the beneficiary object carries the tax type and the official reference.
- paymentMethod.type BillPay, code 0119, flow DIRECT
- beneficiary.billType 0098: Federal taxes
- beneficiary.billReference: the 20-character SAT payment reference
# Example request on Stage — see docs.localpayment.com for the full contract
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" }
}'Frequently asked questions
Where is it available?
In Mexico (MEX), in Mexican pesos (MXN). It runs as a payout: Localpayment sends the funds to a government or service billing reference on the beneficiary’s behalf.
Which taxes can I pay today?
The billType catalog for Mexico covers federal taxes (billType 0098). The catalog grows as new tax and service types are added; confirm it with your account manager before going live with a new type.
What do I need to get started?
API credentials, a dedicated account funded for tax and bill payments, the billType you plan to pay and the bill reference (for Mexico, the SAT payment reference) from the taxpayer or biller.
How do I track each payment?
Localpayment notifies your endpoint of the final status by webhook, with the externalId, billType and billReference. A failed delivery is retried up to 3 times with exponential backoff, and you can always retrieve the transaction through the API.
Does Localpayment check the amount?
No. Your integration declares the amount encoded in the reference and checks that the reference has not been paid already, since a paid reference cannot be reused. Expired SAT references are rejected once validated against the SAT.
Also on the same API
Payouts
Bank payouts over local rails in 14 countries and wallet payouts in 9.
Payouts —Reporting & reconciliation
Reports, APIs and webhooks for finance teams.
Reporting & reconciliation —Payments in Mexico
Methods, rails and licensing in Mexico.
Payments in Mexico —Developer quickstart
Get a token, send your first request and receive a webhook on Stage.
Developer quickstart —
Simplify your tax payment operations in Mexico
Pay federal taxes from the same platform you already use and track every payment through webhook notifications.