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

# pay_invoice

> Execute payment for a 402-protected resource without attempting a direct call first

Execute payment for a 402-protected resource without attempting a direct call first.
Directly calls the HTTPayer router (proxy mode) or relay endpoint (relay mode)
to pay the invoice and retrieve the protected resource.

## Signature

```python theme={null}
client.pay_invoice(api_method: str, api_url: str, api_payload: Optional = None, api_params: Optional = None, api_headers: Optional = None, network: Optional = None)
```

## Parameters

* api\_method: HTTP method (GET, POST, PUT, DELETE, etc.).
* api\_url: Target API URL to access.
* api\_payload: JSON payload for POST/PUT requests.
* api\_params: Query parameters to include.
* api\_headers: Custom headers to send with the request.
* network: Network override for relay mode payments.

## Returns

Response from the target API after successful payment.

## Raises

* ValueError: If network is incompatible with wallet type or not supported.

## Examples

```python theme={null}
>>> client = HTTPayerClient()
>>> response = client.pay_invoice("GET", "https://api.example.com/data")
>>> print(response.json())
```
