> ## Documentation Index
> Fetch the complete documentation index at: https://docs.handle.ng/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Products by Biller

> Retrieve biller packages, tariffs, and dynamic custom field requirements for a specific merchant biller.

Fetch the catalog of bill payment products and dynamic custom form fields configured for a specific biller (e.g. University of Ibadan, AEDC, CAC).

### Custom Fields Structure

Each product returns a `metadata.customFields` array outlining the input fields required to complete payment (e.g., `matriculation_number`, `student_number`, `department`, `graduation_date`).

```json theme={null}
{
  "status": "00",
  "message": "Approved or completed successfully",
  "data": {
    "billerId": "S0000573002",
    "categoryId": "6",
    "products": [
      {
        "billPaymentProductName": "ACCOMMODATION UNDERGRADUATE",
        "billPaymentProductId": "10713664850",
        "isAmountFixed": false,
        "amount": 0,
        "currency": "NGN",
        "metadata": {
          "customFields": [
            {
              "display_name": "Matriculation Number",
              "variable_name": "matriculation_number",
              "type": "numeric",
              "required": true
            }
          ]
        }
      }
    ]
  }
}
```


## OpenAPI

````yaml openapi.json GET /bill-payment/biller/{billerId}/products
openapi: 3.0.3
info:
  title: Handle Merchant Payment Gateway API
  description: >-
    Developer API specification for accepting cardless, instant
    Account-to-Account (A2A) payments via Handle.
  version: 1.0.0
  contact:
    name: Handle Developer Support
    email: support@handle.ng
    url: https://handle.ng
servers:
  - url: https://api-local.handle.ng/api/v1
    description: Local Development (SSL)
  - url: https://api.handle.ng/api/v1
    description: Production Live Gateway
security:
  - BearerAuth: []
paths:
  /bill-payment/biller/{billerId}/products:
    get:
      tags:
        - VAS & Bill Payments
      summary: Get Biller Products & Custom Fields
      description: >-
        Retrieve fee types, tariffs, and dynamic custom field requirements for
        an institutional biller.
      parameters:
        - name: billerId
          in: path
          required: true
          description: Unique Biller ID (e.g. S0000573002)
          schema:
            type: string
            default: S0000573002
          example: S0000573002
      responses:
        '200':
          description: List of products and dynamic custom fields
          content:
            application/json:
              example:
                - billPaymentProductName: ACCEPTANCE FEE
                  billPaymentProductId: '10713664951'
                  isAmountFixed: true
                  amount: 45000
                  currency: NGN
                  metadata:
                    customFields: []
                - billPaymentProductName: TUITION FEES
                  billPaymentProductId: '10713679596'
                  isAmountFixed: false
                  amount: 0
                  currency: NGN
                  metadata:
                    customFields:
                      - display_name: Matriculation Number
                        variable_name: matriculation_number
                        type: numeric
                        required: true
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Supply your secret API key (e.g. `sk_live_...` or `sk_test_...`) in the
        Authorization header.
      x-default: sk_test_handle_master_key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.