Antilopay Node.js SDK

A TypeScript first SDK designed to be used in Node.js (or equivalent environments) for Antilopay payment processor.

Features

This SDK implements all(*) the features outlined in their API document up-to version 1.39 (dated 23.01.2026):

• Payment Creation
• Payment Information
• Webhook Notification
• Payment Cancellation
• Withdraw Creation
• Withdraw Information
• Refund Creation
• Refund Information
• Project Balance
• Steam Top-up

(*) The only exception being the Steam top-up - you're more than welcome to create a PR if you need this feature.

Installation

npm i antilopay-node

Example

const antilopay = AntilopayService.getInstance();

// Reading your secrets from an environment or a secret manager
const secretKey: string = process.env.SECRET_KEY;
const callbackKey: string = process.env.CALLBACK_KEY;
const projectId: string = process.env.PROJECT_ID;
const secretId: string = process.env.SECRET_ID;

// Setting up the Antilopay
antilopay.init({
	projectId: projectId,
	secretId: secretId,
	secretKey: `-----BEGIN RSA PRIVATE KEY-----\n${secretKey}\n-----END RSA PRIVATE KEY-----`,
	callbackKey: `-----BEGIN PUBLIC KEY-----\n${callbackKey}\n-----END PUBLIC KEY-----`,
});

// Create a payment intent
const paymentIntent = await antilopay.createPaymentIntent({
  amount: 10,
  order_id: "TEST1747319801189" // `TEST` + Date.now().toString(),
  currency: "RUB",
  customer: new AntilopayCustomer({
    email: "customer@example.com",
    address: "Moscow",
    fullName: "Customer Name",
    ipAddress: "127.0.0.1",
  }),
  description: "Testing Antilopay SDK",
  product_name: "Test Product",
  product_type: "goods",
  fail_url: "https://example.com/payment-fail",
  success_url: "https://example.com/payment-success",
  merchant_extra: JSON.stringify({
    via: "Website"
  }),
  params: {
    direct_nspk: true,
  },
  prefer_methods: ["CARD_RU", "SBP", "SBER_PAY"],
  product_quantity: 1,
  vat: 0,
});

if (paymentIntent.code !== 0) {
  // Failure! An error occurred...
  console.error(paymentIntent.error);
} else {
  // Success!
  // Payment intent response may something look like this:
  {
    code: 0,
    payment_id: 'APAYXXXXXXXXXXXXXXXXXXXXX',
    direct_nspk: true,
    payment_url: 'https://qr.nspk.ru/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX',
    transaction_id: 'APAYXXXXXXXXXXXXXXXXXXXXXT705C074C07A4375F'
  }

  // Getting the payment status
  const paymentStatus = await antilopay.getPaymentStatus("TEST1747319801189");

  // The payment status response may look like this:
  {
    amount: 9.65,
    original_amount: 10,
    fee: 0,
    // ... other details of the original payment
  }
}

Testing

Run the test suite with Vitest after installing dev dependencies:

npm install
npm test

For watch mode use:

npm run test:watch