asaas-node-sdk v0.1.0

Asaas Node SDK (Unofficial)

An unofficial Node.js/TypeScript SDK for the Asaas payment platform API.

Features

• 🚀 Built with Bun
• 📘 Full TypeScript support
• 🔄 Auto-generated from OpenAPI spec
• ⚡ Promise-based API
• 📦 Modern ESM package
• 🎯 Functional API design

Installation

# Using npm
npm install asaas-node-sdk

# Using yarn
yarn add asaas-node-sdk

# Using pnpm
pnpm add asaas-node-sdk

# Using bun
bun add asaas-node-sdk

Usage

import { createAsaasClient } from 'asaas-node-sdk';

// Initialize the client
const asaas = createAsaasClient({
  apiKey: 'your_api_key',        // Optional: defaults to process.env.ASAAS_API_KEY
  environment: 'sandbox',         // Optional: defaults to 'sandbox' in development, 'production' otherwise
  userAgent: 'my-app/1.0.0'      // Optional: defaults to 'asaas-node-sdk'
});

// Example: List customers
const customers = await asaas.listCustomers({
  query: {
    limit: 10,
    offset: 0
  }
});

// Example: Create a new customer
const customer = await asaas.createNewCustomer({
  body: {
    name: 'John Doe',
    email: 'john@example.com',
    cpfCnpj: '00000000000',
    mobilePhone: '11999999999',
    address: 'Street Name',
    addressNumber: '123',
    province: 'Neighborhood',
    postalCode: '12345678',
    incomeValue: 0
  }
});

// Example: Create a payment
const payment = await asaas.createNewPayment({
  body: {
    customer: customer.id,
    billingType: 'BOLETO',
    value: 100.00,
    dueDate: '2024-12-31'
  }
});

// Example: Get account balance
const balance = await asaas.retrieveAccountBalance();

Environment Variables

The SDK will automatically use these environment variables if available:

• ASAAS_API_KEY: Your Asaas API key
• NODE_ENV: Used to determine the default environment ('production' or 'sandbox')

Development

1. Clone the repository
2. Install dependencies with bun install
3. Build the project with bun run build
4. Run tests with bun test

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Disclaimer

This is an unofficial SDK and is not affiliated with, maintained, authorized, endorsed, or sponsored by Asaas.