SDK — AEPS Module

client.aeps.* — all 15 AEPS operations. Every call is encrypted through the fintech-gateway.

Onboarding

// Register a new micro-ATM agent
await client.aeps.onboardMerchant({ merchantId: 'M-uuid', mobileNumber: '9876543210' });

// Check onboarding status
await client.aeps.getMerchantStatus({ merchantId: 'M-uuid' });

Daily Authentication

Required once per day before the first transaction:

await client.aeps.merchantAuth({
  merchantId: 'M-uuid',
  latitude:   '19.0760',
  longitude:  '72.8777',
  pidData:    '<base64-biometric-from-scanner>',
});

Transactions

All transaction methods share the same body shape:

const body = {
  merchantId:    'M-uuid',
  aadhaarNumber: '9999-9999-9999',
  bankIin:       '607086',
  amount:        1000,           // not required for balance/mini-statement
  pidData:       '<base64-biometric>',
};

await client.aeps.aadhaarPay(body);
await client.aeps.cashWithdrawal(body);
await client.aeps.cashDeposit(body);
await client.aeps.balanceEnquiry(body);    // no amount needed
await client.aeps.miniStatement(body);     // no amount needed

Status

await client.aeps.transactionStatus({ clientRefId: 'REF-uuid' });
await client.aeps.callbackRetry({ clientRefId: 'REF-uuid' });

Banks & Devices

await client.aeps.getBankList();
await client.aeps.getBankByIin({ iin: '607086' });

await client.aeps.registerDevice({
  merchantId: 'M-uuid', deviceSerialNo: 'MANTRA-12345', deviceType: 'FINGERPRINT',
});
await client.aeps.getDevices({ merchantId: 'M-uuid' });

Reporting

await client.aeps.transactionHistory({
  merchantId: 'M-uuid', dateFrom: '2026-07-01', dateTo: '2026-07-04',
});