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
| Parameter | Description |
|---|---|
page | Page number (default: 1) |
limit | Results per page (default: 50) |
partialName | Filter by partial company name |
productType | Filter by type (SERVICE, TOP_UP) |
exchange | Filter by country (ARGENTINA, MEXICO, COLOMBIA, PERU, CHILE) |
IBillCompany fields
IBillCompany fields| Field | Description |
|---|---|
code | Unique company identifier; used in the bill fetch URL |
name | Display name |
productType | Category of the biller |
exchange | Country where the company operates |
asset | Local fiat currency for this company (e.g., ARS, MXN) |
supportedMethods | Array of lookup methods supported by this company |
supportedMethods[].id | Method ID; used in the bill fetch URL |
supportedMethods[].type | Method type string; used in the bill fetch URL |
supportedMethods[].mode | How 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
referenceIdWhat the user inputs depends on the method mode:
| Mode | Example input |
|---|---|
barcode | Barcode number scanned from the bill |
id | CUIT, DNI, or national tax ID |
account | Account or contract number |
IBill fields
IBill fields| Field | Description |
|---|---|
id | Bill ID; pass this to POST /v2/bill-locks as billId |
type | OPEN, CLOSED, or FIXED: determines how amount is handled in the lock |
asset | Currency the bill is denominated in (e.g., ARS, MXN, COP, PEN, CLP) |
exchange | Country where the bill resides (e.g., ARGENTINA, MEXICO). Matches the company's exchange |
amount | Amount for CLOSED bills; minimum suggested amount for OPEN bills |
minAmount | Minimum accepted amount (OPEN bills) |
maxAmount | Maximum accepted amount (OPEN bills) |
expireAt | Bill expiry timestamp; do not attempt payment after this time |
Bill types
| Type | Behavior |
|---|---|
CLOSED | Fixed amount; pass id to lock without amount |
OPEN | Variable amount within minAmount/maxAmount; amount required in lock |
FIXED | Choose from allowedAmounts array; amount required in lock |
Continue to Lock payment once you have a bill id.
Updated 27 days ago
Did this page help you?