# Billing Portal

[API Reference](https://docs.credyt.ai/api/billing-portal-create-portal-session.md)

The Billing Portal enables you to offer your customers a comprehensive billing experience, providing them with visibility into their balances, usage and top-up history. From here they can top up their accounts directly and manage their billing settings. More information on the billing portal can be found [here](https://docs.credyt.ai/features/billing-portal.md).

## Start a billing portal session[​](#start-a-billing-portal-session "Direct link to Start a billing portal session")

Your customers do not need to register for Credyt in order to use the billing portal. Instead, you manage their access by generating a billing portal *session*, once you have authenticated and validated the user within your service.

Let's open up the billing portal for the customer we've been working with:

* REST API
* TypeScript SDK
* Python SDK

POST https\://api.credyt.ai/billing-portal/sessions

```json
{
  "customer_id": "{{customerId}}",
  "return_url": "https://glitch.ai/account",
  "failure_url": "https://glitch.ai/callbacks/credyt/failure"
}

```

```typescript
await client.billingPortal.createPortalSession({
  customerId: "{{customerId}}",
  returnUrl: "https://glitch.ai/account",
  failureUrl: "https://glitch.ai/callbacks/credyt/failure",
});

```

[View full sample on GitHub](https://github.com/credyt/sdk-ts/blob/main/samples/billingPortalCreatePortalSessionSample.ts#L11)

```python
response = client.billing_portal.create_portal_session(
    body={
    "customer_id": "{{customerId}}",
    "return_url": "https://glitch.ai/account",
    "failure_url": "https://glitch.ai/callbacks/credyt/failure",
  },
)

```

[View full sample on GitHub](https://github.com/credyt/sdk-python/blob/main/samples/billing_portal_create_portal_session_start_a_session.py#L20)

The `redirect_url` is a pre-authenticated URL where you send your customer. This link is valid for 10 minutes.

Return and Failure URLs

When creating a billing portal session you specify both the URL the customer should return to when exiting the portal (`return_url`) and the failure URL (`failure_url`) we will redirect them to if their session expires or there are any issues. You can find more about failure handling [here](https://docs.credyt.ai/features/billing-portal.md).

If you navigate to this URL you should see their recently updated balance and usage.

![Credyt\'s Billing Portal](/assets/images/billing-portal-11c343c1d1b18b46fa148cf70cea918f.png)