A self-hosted UPI & COD payment gateway with zero per-transaction platform fees, universal JavaScript checkout integration, dynamic QR payments, WhatsApp OTP authentication, and automated payment verification.
JavaScript
import { generateHmac } from '@youpi/common';
/**
* Android Observer Simulator / Driver.
* Emulates the native Android Kotlin application for headless testing,
* CI/CD verification, and local development.
*/
export class AndroidObserverDriver {
/**
* @param {{
* apiBaseUrl?: string,
* deviceName?: string,
* deviceModel?: string
* }} options
*/
constructor(options = {}) {
let url = options.apiBaseUrl || process.env.BASE_PAYMENT_API_URL || 'http://localhost:6100';
while (url.endsWith('/')) url = url.slice(0, -1);
this.apiBaseUrl = url;
this.deviceName = options.deviceName || 'Pixel 8 Pro';
this.deviceModel = options.deviceModel || 'Google Pixel';
this.deviceId = null;
this.signingKey = null;
this.heartbeatTimer = null;
}
/**
* Pairs device with self-hosted gateway using enrollment token.
* @param {string} enrollmentToken
* @param {string} [merchantId]
*/
async pair(enrollmentToken, merchantId = null) {
const url = `${this.apiBaseUrl}/api/v1/pollers/android/pair`;
const payload = {
enrollmentToken,
deviceName: this.deviceName,
deviceModel: this.deviceModel,
merchantId
};
const res = await fetch(url, {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload)
});
if (!res.ok) {
const err = await res.text();
throw new Error(`Device pairing failed [HTTP ${res.status}]: ${err}`);
}
const data = await res.json();
this.deviceId = data.deviceId;
this.signingKey = data.signingKey;
return data;
}
/**
* Submits a signed payment observation to backend.
* @param {{
* amount: string | number,
* amountPaise?: bigint | number,
* receivingAccountId?: string,
* observedAt?: Date | string,
* utr?: string,
* senderVpa?: string,
* notificationText?: string,
* timestampOverride?: number
* }} obs
*/
async submitObservation(obs) {
if (!this.deviceId || !this.signingKey) {
throw new Error('Device must be paired before submitting observations.');
}
const url = `${this.apiBaseUrl}/api/v1/pollers/android/events`;
const timestamp = (obs.timestampOverride !== undefined ? obs.timestampOverride : Date.now()).toString();
const bodyObj = {
deviceId: this.deviceId,
clientMessageId: obs.clientMessageId,
receivingAccountId: obs.receivingAccountId || '00000000-0000-0000-0000-000000000002',
amount: obs.amount,
amountPaise: obs.amountPaise !== undefined ? obs.amountPaise.toString() : undefined,
observedAt: (obs.observedAt instanceof Date ? obs.observedAt : new Date(obs.observedAt || Date.now())).toISOString(),
bankReferenceNumber: obs.utr,
senderVpa: obs.senderVpa,
rawNotification: obs.rawNotification !== undefined ? obs.rawNotification : {
title: obs.notificationTitle || 'Payment Received',
text: obs.notificationText || `Received Rs ${obs.amount} via UPI`,
package: obs.package !== undefined ? obs.package : 'com.phonepe.app'
}
};
const bodyString = JSON.stringify(bodyObj);
const sigPayload = `${bodyString}:${timestamp}`;
const signature = generateHmac(sigPayload, this.signingKey);
const res = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Device-Id': this.deviceId,
'X-Timestamp': timestamp,
'X-Signature': signature
},
body: bodyString
});
const respText = await res.text();
let respJson;
try {
respJson = JSON.parse(respText);
} catch {
respJson = { raw: respText };
}
return {
status: res.status,
body: respJson
};
}
/**
* Submits heartbeat to backend.
*/
/**
* Submits a signed raw bank SMS observation to backend.
* @param {{
* sender: string,
* body: string,
* clientMessageId?: string,
* timestampOverride?: number
* }} sms
*/
async submitSms(sms) {
if (!this.deviceId || !this.signingKey) {
throw new Error('Device must be paired before submitting SMS.');
}
const url = `${this.apiBaseUrl}/api/v1/observers/sms`;
const timestamp = (sms.timestampOverride !== undefined ? sms.timestampOverride : Date.now()).toString();
const bodyObj = {
deviceId: this.deviceId,
clientMessageId: sms.clientMessageId,
sender: sms.sender || 'VK-HDFCBK',
body: sms.body,
timestamp: Number(timestamp)
};
const bodyString = JSON.stringify(bodyObj);
const sigPayload = `${bodyString}:${timestamp}`;
const signature = generateHmac(sigPayload, this.signingKey);
const res = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Device-Id': this.deviceId,
'X-Timestamp': timestamp,
'X-Signature': signature
},
body: bodyString
});
const respText = await res.text();
let respJson;
try {
respJson = JSON.parse(respText);
} catch {
respJson = { raw: respText };
}
return {
status: res.status,
body: respJson
};
}
async sendHeartbeat() {
if (!this.deviceId) throw new Error('Cannot send heartbeat: device not paired.');
const url = `${this.apiBaseUrl}/api/v1/pollers/android/heartbeat`;
const res = await fetch(url, {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-Device-Id': this.deviceId
},
body: JSON.stringify({ deviceId: this.deviceId, timestamp: Date.now() })
});
return await res.json();
}
startHeartbeat(intervalMs = 60000) {
if (this.heartbeatTimer) return;
this.heartbeatTimer = setInterval(() => {
this.sendHeartbeat().catch(() => {});
}, intervalMs);
}
stopHeartbeat() {
if (this.heartbeatTimer) {
clearInterval(this.heartbeatTimer);
this.heartbeatTimer = null;
}
}
}