TypeScript SDK

npm install @billions-works/sdk-ts

import { BillionsApi } from '@billions-works/sdk-ts';

const api = new BillionsApi({
  apiKey: process.env.BILLIONS_API_KEY!,
});

const invoice = await api.createInvoice({
  currency: 'USDT',
  amount: 100,
  order_no: 'ORDER-1001',
  idempotencyKey: 'ORDER-1001-attempt-1',
  callbackUrl: 'https://example.com/webhooks/billions',
});

console.log(invoice.invoice_url);

const version = await api.getVersion();
const currencies = await api.getCurrencies();
const invoice = await api.getInvoice('invoice-id');
const invoices = await api.getInvoicesByOrder('ORDER-1001');
const verifiedInvoice = await api.verifyInvoicePaid(callbackData);

import {
  CallbackVerificationError,
  InvoiceNotPaidError,
} from '@billions-works/sdk-ts';

try {
  const invoice = await api.verifyInvoicePaid({
    id: callback.id,
    status: callback.status,
    paid_amount: callback.paid_amount,
  });

  // Transition invoice.order_no to paid exactly once.
} catch (error) {
  if (
    error instanceof InvoiceNotPaidError ||
    error instanceof CallbackVerificationError
  ) {
    // Do not mark the order as paid.
  }
}