ver-pay

NPM package for verifying payment receipts across multiple Ethiopian banks.

Supported banks

• cbe
• cbebirr
• dashen
• abyssinia
• awash

Install

npm install ver-pay

Quick usage

import { verifyPayment } from "ver-pay";

const result = await verifyPayment({
  bank: "cbe",
  transactionId: "TX123",
  account: "100012345678",
  transactionReference: "ABC123",
});

if (result.success) {
  console.log("Verified", result.amount, result.reference);
} else {
  console.error("Verification failed", result.error || result.reason);
}

Advanced usage (custom adapters)

import { createPaymentVerifier, type BankAdapter } from "ver-pay";

class MyBankAdapter implements BankAdapter {
  async verify() {
    return { success: true, reference: "MY-REF" };
  }
}

const verifier = createPaymentVerifier();
verifier.registerAdapter("mybank", new MyBankAdapter());

const result = await verifier.verifyPayment({
  bank: "mybank",
  transactionId: "TX-1",
});

API

verifyPayment(request)

Request type:

{
  bank: string;
  transactionId?: string;
  account?: string;
  transactionReference?: string;
  receiptNumber?: string;
  phoneNumber?: string;
}

createPaymentVerifier(customAdapters?)

Returns a PaymentVerifier instance with:

• verifyPayment(request)
• registerAdapter(bank, adapter)
• getSupportedBanks()

Build and test

pnpm build
pnpm test

Publish to npm

1. Login: npm login
2. Bump version: npm version patch
3. Publish: npm publish --access public