💸 Cryptomus TypeScript SDK

A simple and lightweight TypeScript SDK for interacting with the Cryptomus API. Easily manage crypto payments, wallets, and refunds in your Node.js applications.

🚀 Features

• 🔐 Generate secure signatures
• 💰 Create and refund payments
• 👛 Create and block wallets
• 📄 Retrieve payment and wallet info
• 🧾 View payment history
• 🔁 Resend webhooks
• 🧩 List supported services
• 📦 Fully written in TypeScript

📦 Installation

npm install @zukrein/cryptomus

🔧 Usage

import { Cryptomus } from "@zukrein/cryptomus";

const cryptomus = new Cryptomus({
  paymentKey: "YOUR_PAYMENT_KEY",
  payoutKey: "YOUR_PAYOUT_KEY",
  merchantId: "YOUR_MERCHANT_ID",
});

// Create a payment
const payment = await cryptomus.createPayment({
  amount: "10",
  currency: "USD",
  orderId: "ORDER12345",
  url_callback: "https://yourdomain.com/callback",
  url_return: "https://yourdomain.com/return",
});

console.log(payment);

📚 API Methods

| Method | Description | | ----------------------------------------- | ---------------------------------------- | | createPayment(options) | Create a new payment | | getPayment({ uuid, order_id }) | Get payment details | | refundPayment(options) | Issue a refund for a payment | | createWallet(options) | Create a new wallet address | | blockWallet(options) | Block a wallet (optionally force refund) | | refundFromBlockedWallet(options) | Refund from a blocked wallet | | generateQrCode({ wallet_address_uuid }) | Generate a QR code for a wallet | | resendWebhook({ uuid, order_id }) | Resend a webhook | | listServices() | List available currencies and services | | paymentHistory({ date_from, date_to }) | Retrieve payment history |

🧪 Type Safety

This SDK uses TypeScript interfaces and enums to provide autocomplete and ensure safe integration into your project.

📄 License

MIT License

🤝 Contributing

Contributions, issues, and feature requests are welcome!

1. Fork the project
2. Create your feature branch (git checkout -b feature/YourFeature)
3. Commit your changes (git commit -m 'Add YourFeature')
4. Push to the branch (git push origin feature/YourFeature)
5. Open a Pull Request