# Overview

The official TypeScript/JavaScript SDK for the AstraPay API. Zero runtime dependencies — uses native `fetch`.

**Package:** `@astra-pay/sdk`\
**Requires:** Node.js >= 18.0.0

***

## Installation

```bash
npm install @astra-pay/sdk
# or
yarn add @astra-pay/sdk
```

***

## Quick start

```typescript
import { AstraPayClient } from "@astra-pay/sdk";

const client = new AstraPayClient("ap_live_your_api_key");

const payment = await client.payments.create({
  amount: 49.99,
  token: "USDC",
  network: "BASE",
  customer_email: "john@example.com",
  redirect_url: "https://yourapp.com/success",
});

console.log(payment.checkout_url);
// => "https://pay.byastra.ai/purchases/pXk9mQ"
```

***

## Constructor

```typescript
const client = new AstraPayClient(apiKey: string, options?: ClientOptions);
```

| Parameter         | Type     | Default                     | Description             |
| ----------------- | -------- | --------------------------- | ----------------------- |
| `apiKey`          | `string` | —                           | Your API key (required) |
| `options.baseUrl` | `string` | `https://apipay.byastra.ai` | Override API base URL   |
| `options.prefix`  | `string` | `/v1`                       | API route prefix        |

***

## Available modules

| Module                                                                        | Description                        |
| ----------------------------------------------------------------------------- | ---------------------------------- |
| [`client.payments`](https://docs.chatastra.ai/astrapay-api-docs/sdk/payments) | Create, get, list, cancel payments |
| [`client.products`](https://docs.chatastra.ai/astrapay-api-docs/sdk/products) | Full CRUD on products              |
| [`client.webhooks`](https://docs.chatastra.ai/astrapay-api-docs/sdk/webhooks) | Register and manage webhooks       |