Coverage

Bill Payments are available in the following countries:

CountryExchangeLocal currency
ArgentinaARGENTINAARS
MexicoMEXICOMXN
ColombiaCOLOMBIACOP
PeruPERUPEN
ChileCHILECLP

Each bill company includes an exchange field indicating its country and an asset field with the local settlement currency. Use the exchange query parameter on GET /crypto/v2/info/bill-companies to filter companies by country.

Amounts are returned as plain strings with the currency in a separate field. See Currency display for the symbol and decimals of each one.

Bill types

Each bill returned by discovery has one of three types:

TypeDescription
CLOSEDThe biller sets the amount (amount). No input needed: the lock uses it.
OPENThe user chooses the amount, between minAmount and maxAmount.
FIXEDThe user picks one of the allowedAmounts (typical for top-ups).

For OPEN and FIXED bills, amount is required in the lock request. For CLOSED bills, the bill amount is always used.


Product types

Companies are categorized by productType:

productTypeDescription
SERVICEUtility or service bill (electricity, gas, internet, insurance)
TOP_UPPrepaid top-up (mobile credit, transport cards)

Did this page help you?