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

# Camel.toolkits.stripe toolkit

<a id="camel.toolkits.stripe_toolkit" />

<a id="camel.toolkits.stripe_toolkit.StripeToolkit" />

## StripeToolkit

```python theme={"system"}
class StripeToolkit(BaseToolkit):
```

A class representing a toolkit for Stripe operations.

This toolkit provides methods to interact with the Stripe API,
allowing users to operate stripe core resources, including Customer,
Balance, BalanceTransaction, Payment, Refund

Use the Developers Dashboard [https://dashboard.stripe.com/test/apikeys](https://dashboard.stripe.com/test/apikeys) to
create an API keys as STRIPE\_API\_KEY.

**Parameters:**

* **logger** (Logger): a logger to write logs.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.__init__" />

### **init**

```python theme={"system"}
def __init__(self, retries: int = 3, timeout: Optional[float] = None):
```

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.customer_get" />

### customer\_get

```python theme={"system"}
def customer_get(self, customer_id: str):
```

Retrieve a customer by ID.

**Parameters:**

* **customer\_id** (str): The ID of the customer to retrieve.

**Returns:**

str: The customer data as a str.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.customer_list" />

### customer\_list

```python theme={"system"}
def customer_list(self, limit: int = 100):
```

List customers.

**Parameters:**

* **limit** (int, optional): Number of customers to retrieve. (default: :obj:`100`)

**Returns:**

str: An output str if successful, or an error message string if
failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.balance_get" />

### balance\_get

```python theme={"system"}
def balance_get(self):
```

**Returns:**

str: A str containing the account balance if successful, or an
error message string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.balance_transaction_list" />

### balance\_transaction\_list

```python theme={"system"}
def balance_transaction_list(self, limit: int = 100):
```

List your balance transactions.

**Parameters:**

* **limit** (int, optional): Number of balance transactions to retrieve. (default::obj:`100`)

**Returns:**

str: A list of balance transaction data if successful, or an error
message string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.payment_get" />

### payment\_get

```python theme={"system"}
def payment_get(self, payment_id: str):
```

Retrieve a payment by ID.

**Parameters:**

* **payment\_id** (str): The ID of the payment to retrieve.

**Returns:**

str:The payment data as a str if successful, or an error message
string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.payment_list" />

### payment\_list

```python theme={"system"}
def payment_list(self, limit: int = 100):
```

List payments.

**Parameters:**

* **limit** (int, optional): Number of payments to retrieve. (default::obj:`100`)

**Returns:**

str: A list of payment data if successful, or an error message
string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.refund_get" />

### refund\_get

```python theme={"system"}
def refund_get(self, refund_id: str):
```

Retrieve a refund by ID.

**Parameters:**

* **refund\_id** (str): The ID of the refund to retrieve.

**Returns:**

str: The refund data as a str if successful, or an error message
string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.refund_list" />

### refund\_list

```python theme={"system"}
def refund_list(self, limit: int = 100):
```

List refunds.

**Parameters:**

* **limit** (int, optional): Number of refunds to retrieve. (default::obj:`100`)

**Returns:**

str: A list of refund data as a str if successful, or an error
message string if failed.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.handle_exception" />

### handle\_exception

```python theme={"system"}
def handle_exception(self, func_name: str, error: Exception):
```

Handle exceptions by logging and returning an error message.

**Parameters:**

* **func\_name** (str): The name of the function where the exception occurred.
* **error** (Exception): The exception instance.

**Returns:**

str: An error message string.

<a id="camel.toolkits.stripe_toolkit.StripeToolkit.get_tools" />

### get\_tools

```python theme={"system"}
def get_tools(self):
```

**Returns:**

List\[FunctionTool]: A list of FunctionTool objects for the
toolkit methods.
