Node.js SDK @watenga/node

npm install @watenga/node

import Watenga from '@watenga/node';

const watenga = new Watenga(process.env.WATENGA_SECRET_KEY!); // sk_test_...

const checkout = await watenga.checkout.create({
  amount: '25.00',
  currency: 'USD',
  merchant_transaction_id: 'ORD-1001',
  return_url: 'https://shop.example/return',
});
// Send the buyer to checkout.payment_url

import express from 'express';
import { Webhooks } from '@watenga/node';

app.post('/webhooks', express.raw({ type: 'application/json' }), (req, res) => {
  let event;
  try {
    event = Webhooks.constructEvent(req.body, req.headers['watenga-signature'] as string, process.env.WATENGA_WEBHOOK_SECRET!);
  } catch {
    return res.sendStatus(400);
  }
  if (event.type === 'payment.capture.completed') {
    // fulfil the order for event.data.object (a transaction)
  }
  res.sendStatus(200);
});

import { WatengaApiError } from '@watenga/node';

try {
  await watenga.refunds.create('txn_...', { amount: '5.00', reason: 'customer_request' });
} catch (err) {
  if (err instanceof WatengaApiError) {
    console.error(err.code, err.statusCode, err.param, err.requestId, err.docUrl);
  }
}

// Every write gets an Idempotency-Key, kept across the SDK's own retries.
// When you retry a call yourself, pass the same key:
await watenga.refunds.create('txn_...', { reason: 'duplicate' }, { idempotencyKey: 'refund-ORD-1001' });

const page = await watenga.transactions.list({ status: 'completed', limit: 50 });
// { object: 'list', data: [...], has_more, next_cursor }

for await (const txn of watenga.transactions.listAll({ status: 'completed' })) {
  console.log(txn.id, txn.amount, txn.currency);
}