A bank account
for every customer.
Auto-matched. Instant.

import Sendexa from "sendexa";

const client = new Sendexa(process.env.SENDEXA_API_KEY);

// 1. Create a virtual account for a customer
const va = await client.virtualAccounts.create({
  customer_id: "cust_001",
  label: "Kwame Asante",
  currency: "GHS",
  bank: "gcb",                // preferred bank
  type: "permanent",          // or "temporary"
  match_rule: "exact",        // "exact" | "any" | "threshold"
  notify: {
    webhook: "https://myapp.co/webhooks/sendexa",
    email: "kwame@techapp.gh",
  },
  metadata: { plan: "pro", invoice_id: null },
});

console.log(va.account_number); // → "200-441-8821"
console.log(va.bank_name);      // → "GCB Bank"
console.log(va.account_name);   // → "Sendexa / Kwame Asante"

// Share these details with your customer.
// They transfer from any bank in Ghana.

// 2. Handle the webhook when payment arrives
app.post("/webhooks/sendexa", async (req, res) => {
  const event = req.body;

  if (event.event === "virtual_account.credited") {
    const { customer_id, amount, currency, sender, bank } = event.data;

    // Mark invoice paid, activate plan, etc.
    await markInvoicePaid(customer_id, amount);

    console.log(`${currency} ${amount} received from ${sender.name} (${bank})`);
  }

  res.json({ received: true });
});

// 3. Query account balance & history
const balance = await client.virtualAccounts.balance("va_8821");
const history = await client.virtualAccounts.transactions("va_8821", {
  from: "2025-01-01",
  to:   "2025-03-31",
  limit: 50,
});