> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.pay4power.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.pay4power.com/_mcp/server.

# Services and Providers

> Discover available bill-payment categories and provider codes before vending.

The services and providers endpoints define what your account can vend. Call them during setup, cache the results for your user interface, and refresh them periodically.

## Services

```http
GET /services
```

Services represent product categories such as electricity, airtime, data, and TV.

## Providers

```http
GET /providers
```

Providers represent the billers or networks available inside a service category. Provider responses include codes that are passed into validation, initiation, package, or vend requests.

## Integration pattern

1. Load services.
2. Load providers for the selected service.
3. Store the provider `code`.
4. Pass the code into the relevant product endpoint.

## Caching guidance

Provider lists do not need to be fetched before every transaction. Cache them, but refresh regularly so new billers and package changes appear in your application.