Tax, Bill and Service Payments Overview

Tax, bill and service payments is a Localpayment payout method (paymentMethod.type: BillPay) for statutory tax, bill, and service payments. Instead of sending funds to a beneficiary's bank account, you send funds to a government or service billing reference on the beneficiary's behalf.

This article is for integrators who need to disburse these payments programmatically. It covers scope, the end-to-end payment flow, and transaction states. For the API reference and code examples, see Send a Tax, Bill, or Service Payment.

Scope


Country	Mexico (MEX)
Currency	MXN
Operation type	Payout
Payment method	Tax, Bill and Service Payments (`BillPay`, code `0119`)
Flow	`DIRECT`

ℹ️
Localpayment does not validate that the declared amount matches the amount encoded in the bill reference. Your integration is responsible for declaring the correct amount before submitting the request.

Before You Begin

Valid API credentials (access token).
A dedicated account funded for tax and bill payments.
The billType catalog validated for the tax or service types you plan to pay (see BillType Catalog below).

Payment Flow

%%{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 Your Backend
  participant LP as Localpayment
  participant Fisco as Tax Authority / Biller

  Dev->>LP: Submit the bill payment (tax type and bill reference)
  LP->>LP: Check the payment details
  alt Approval required
    LP-->>Dev: Payment is waiting for your approval
    Dev->>LP: Approve the payment
  end
  LP->>Fisco: Send the payment
  Fisco-->>LP: Confirm the payment was received
  LP-->>Dev: Notify you the payment is complete

You send a request to POST /api/payout/ with paymentMethod.type set to BillPay, including billType and billReference in the beneficiary object.
Localpayment validates the required fields and the billType catalog.
If requireAuth is true, the transaction remains in PendingAuth until you call the authorization endpoint.
Localpayment processes the payment with the tax authority or biller.
Localpayment updates the transaction status and notifies you by webhook.

Transaction States

Status	Type	Description
`PENDING`	Intermediate	The transaction was received and is being processed.
`PENDING_AUTH`	Intermediate	`requireAuth` was `true`. Waiting for you to call the authorization endpoint.
`IN_PROGRESS`	Intermediate	The transaction is being processed by the biller.
`COMPLETED`	Final	The payment was processed successfully.
`FAILED`	Final	The payment was rejected. Check the `errors` array in the response.
`EXPIRED`	Final	The transaction exceeded the processing time limit.
`REVERSED`	Final	The payment was reversed.

BillType Catalog

The billType field identifies the tax or service being paid. The catalog available for Mexico:

Code	Description
`0098`	Federal taxes

⚠️
The billType catalog grows as new tax and service types are added. Confirm the current catalog with your Localpayment account manager before going live with a new type.

Next Steps

Send a Tax, Bill, or Service Payment

API reference, request and response examples, and webhook notifications.

Approvals & Double Signature

Learn how to authorize a payout created with requireAuth.