Discover bills

Discover bills

Discovering bills is the first step in the Bill Payments flow. You first find the company and its supported lookup methods, then retrieve the outstanding bills for a specific reference ID.

1. List available bill companies

curl "https://sandbox.manteca.dev/crypto/v2/info/bill-companies?page=1&limit=50&partialName=agua&productType=SERVICE&exchange=ARGENTINA" \
  -H "md-api-key: $MD_API_KEY"
{
  "data": [
    {
      "code": "AR-S-0009",
      "name": "Aguas Danone",
      "productType": "SERVICE",
      "exchange": "ARGENTINA",
      "asset": "ARS",
      "supportedMethods": [
        {
          "id": "275ee934-7883-4076-888a-e9bb4bef8f5d",
          "type": "00NH-BAR",
          "description": "Aguas Danone pago por codigo de barras",
          "mode": "barcode"
        }
      ]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "pageCount": 2,
  "lastPage": 1,
  "totalCount": 2
}

Query parameters

ParameterDescription
pagePage number (default: 1)
limitResults per page (default: 50)
partialNameFilter by partial company name
productTypeFilter by type (SERVICE, TOP_UP)
exchangeFilter by country (ARGENTINA, MEXICO, COLOMBIA, PERU, CHILE)

IBillCompany fields

FieldDescription
codeUnique company identifier; used in the bill fetch URL
nameDisplay name
productTypeCategory of the biller
exchangeCountry where the company operates
assetLocal fiat currency for this company (e.g., ARS, MXN)
supportedMethodsArray of lookup methods supported by this company
supportedMethods[].idMethod ID; used in the bill fetch URL
supportedMethods[].typeMethod type string; used in the bill fetch URL
supportedMethods[].modeHow the user provides their reference (barcode, id, etc.)

Popular companies shortcut

curl "https://sandbox.manteca.dev/crypto/v2/info/popular-bill-companies?exchange=ARGENTINA" \
  -H "md-api-key: $MD_API_KEY"

Returns the most frequently used companies of the country in exchange (default ARGENTINA), grouped by category: an object whose keys are category names and whose values are lists of bill companies. Useful for surfacing common billers in your UI without requiring a search.


2. Retrieve outstanding bills

Use the code, id, and type from a supportedMethods entry, plus the user-supplied referenceId.

curl "https://sandbox.manteca.dev/crypto/v2/info/bill-companies/AR-S-0009/275ee934-7883-4076-888a-e9bb4bef8f5d/00NH-BAR/1234567890" \
  -H "md-api-key: $MD_API_KEY"
[
  {
    "id": "9bdc5674-ea24-4242-8eb9-30d4eecd327b-0",
    "companyCode": "AR-S-02610",
    "companyName": "Sandbox 1",
    "companyCategory": "TARJETAS",
    "methodId": "5c9fc993-73a9-4929-ab8b-2b75b9864329",
    "methodType": "0UAB-CLI",
    "referenceId": "1000000001",
    "productType": "SERVICE",
    "asset": "ARS",
    "exchange": "ARGENTINA",
    "type": "OPEN",
    "amount": "5008",
    "minAmount": "1000",
    "maxAmount": "800000",
    "expireAt": "2026-07-08T00:00:00.000-03:00"
  }
]

referenceId

What the user inputs depends on the method mode:

ModeExample input
barcodeBarcode number scanned from the bill
idCUIT, DNI, or national tax ID
accountAccount or contract number

IBill fields

FieldDescription
idBill ID; pass this to POST /v2/bill-locks as billId
typeOPEN, CLOSED, or FIXED: determines how amount is handled in the lock
assetCurrency the bill is denominated in (e.g., ARS, MXN, COP, PEN, CLP)
exchangeCountry where the bill resides (e.g., ARGENTINA, MEXICO). Matches the company's exchange
amountAmount for CLOSED bills; minimum suggested amount for OPEN bills
minAmountMinimum accepted amount (OPEN bills)
maxAmountMaximum accepted amount (OPEN bills)
expireAtBill expiry timestamp; do not attempt payment after this time

Bill types

TypeBehavior
CLOSEDFixed amount; pass id to lock without amount
OPENVariable amount within minAmount/maxAmount; amount required in lock
FIXEDChoose from allowedAmounts array; amount required in lock

Continue to Lock payment once you have a bill id.


Did this page help you?