Bill payments

nuez can query and pay utility bills (electricity, gas, telecom, and similar) through the same bill-payment network used by Rapipago/Pago Fácil terminals. This feature is gated by the BILL_PAYMENTS_ENABLED server flag (on by default) — the corresponding MCP tools and REST routes simply don’t register if it’s off.

Finding a company

search_bill_companies searches by name or code:

{ "companies": [{ "code": "EDENOR", "name": "EDENOR", "supportedMethods": [{ "id": "...", "type": "...", "description": "..." }] }], "count": 1 }

Querying a bill

get_bill takes company_code and ref_id (the reference/client number from the physical or digital invoice) and returns the outstanding amount, if fixed:

{ "bills": [{ "companyName": "EDENOR", "referenceId": "...", "type": "FIXED", "amount": "18500.00", "expireAt": "2026-08-01T00:00:00Z" }], "count": 1, "method_id": "..." }

Paying a bill

pay_bill takes company_code and ref_id. If the bill type is OPEN (variable amount) and you didn’t pass amount_ars, it returns a requires_amount: true response with minAmount/maxAmount/allowedAmounts instead of paying — call again with amount_ars set.

{ "id": "c2f0...", "company_name": "EDENOR", "amount_ars": 18500, "status": "pending" }

Auto-approve whitelist

Add a company to the whitelist so future payments to it skip manual confirmation, optionally capped by per_payment_limit_ars:

add_bill_to_whitelist — company_code, optional per_payment_limit_ars
remove_bill_from_whitelist — company_code
list_bill_whitelist — current entries

History

list_bill_payments returns recent payments with their status (pending, completed, failed, etc.) and, when available, confirmation_code or reject_reason.

MCP tools

Full parameter reference at MCP tools → Bill payments.