simplepay-js-sdk 0.11.1 → 0.12.0

package/README.md

@@ -95,12 +95,38 @@ A `response` a következő tulajdonságokkal rendelkezik:
 #### IPN végpont
 
 A SimplePay `POST` kérést küld az IPN URL-re, és válaszolnunk kell rá.
-Ennél a végpontnál a következőket kell tenned:
+
+**Ajánlott megközelítés a `handleIpnRequest` függvénnyel:**
+
+```typescript
+import { handleIpnRequest } from 'simplepay-js-sdk'
+
+// Az IPN végpont kezelőjében (pl. Express, Next.js, stb.)
+const ipnBody = await request.text() // A nyers body stringként (fontos: használd a .text()-et, ne a JSON.parse()-t)
+const incomingSignature = request.headers.get('Signature')
+const { MERCHANT_KEY } = getSimplePayConfig('HUF') // vagy a te valutád
+
+const { responseBody, signature } = handleIpnRequest(ipnBody, incomingSignature, MERCHANT_KEY)
+
+// Válasz küldése HTTP 200 státusszal
+return new Response(responseBody, {
+  status: 200,
+  headers: {
+    'Content-Type': 'application/json',
+    'Signature': signature
+  }
+})
+```
+
+**Manuális megközelítés:**
+
+Ha manuálisan szeretnéd kezelni:
 
 - ellenőrizd az aláírás érvényességét - használd a `checkSignature(ipnBody, signatureHeader, SIMPLEPAY_MERCHANT_KEY_HUF)` függvényt
-- adj hozzá egy `receiveDate` tulajdonságot a kapott JSON-hoz
+- adj hozzá egy `receiveDate` tulajdonságot a kapott JSON-hoz (ISO 8601 formátumban, pl. `2025-10-06T07:00:34+02:00`)
 - számítsd ki az új aláírást - használd a `generateSignature(responseText, SIMPLEPAY_MERCHANT_KEY_HUF)` függvényt
-- küldd el a `response`-t az új `signature`-rel
+- küldd el a `response`-t az új `signature`-rel a HTTP fejlécben (ne a JSON body-ban)
+- **Fontos**: A válasz JSON-nak tömörnek kell lennie (szóközmentes). A `JSON.stringify()` alapból tömör JSON-t ad vissza.
 
 ### Ismétlődő fizetés
 

package/dist/index.d.ts

@@ -10,6 +10,39 @@ export declare const generateSignature: (body: string, merchantKey: string) => s
 
 export declare const getPaymentResponse: (r: string, signature: string) => SimplePayResult;
 
+/**
+ * Handles IPN (Instant Payment Notification) request and generates response
+ *
+ * This function implements the IPN flow according to SimplePay requirements:
+ * 1. Validates the incoming signature
+ * 2. Adds receiveDate property to the response
+ * 3. Generates response signature
+ *
+ * @param ipnBody - The raw IPN request body as string (must be the exact string received, not parsed JSON)
+ * @param incomingSignature - The signature from the 'Signature' HTTP header
+ * @param merchantKey - The merchant secret key for signature validation and generation
+ * @returns Object containing the response JSON string and signature to send back
+ *
+ * @example
+ * // In your IPN endpoint handler:
+ * const ipnBody = await request.text() // Get raw body as string
+ * const incomingSignature = request.headers.get('Signature')
+ * const { responseBody, signature } = handleIpnRequest(ipnBody, incomingSignature, MERCHANT_KEY)
+ *
+ * // Send response with HTTP 200 status
+ * return new Response(responseBody, {
+ *   status: 200,
+ *   headers: {
+ *     'Content-Type': 'application/json',
+ *     'Signature': signature
+ *   }
+ * })
+ */
+export declare const handleIpnRequest: (ipnBody: string, incomingSignature: string, merchantKey: string) => {
+    responseBody: string;
+    signature: string;
+};
+
 declare type ISO8601DateString = string;
 
 export declare type Language = typeof LANGUAGES[number];
@@ -52,7 +85,7 @@ declare interface RecurringPaymentData extends PaymentData {
     recurring: Recurring;
 }
 
-declare interface SimplePayCancelCardResponse {
+export declare interface SimplePayCancelCardResponse {
     salt: string;
     merchant: string;
     cardId: string;
@@ -62,11 +95,11 @@ declare interface SimplePayCancelCardResponse {
 
 declare type SimplePayEvents = 'SUCCESS' | 'FAIL' | 'TIMEOUT' | 'CANCEL';
 
-declare interface SimplePayRecurringResponse extends SimplePayResponse {
+export declare interface SimplePayRecurringResponse extends SimplePayResponse {
     tokens: string[];
 }
 
-declare interface SimplePayResponse {
+export declare interface SimplePayResponse {
     salt: string;
     merchant: string;
     orderRef: string;
@@ -78,7 +111,7 @@ declare interface SimplePayResponse {
     errorCodes?: string[];
 }
 
-declare interface SimplePayResult {
+export declare interface SimplePayResult {
     responseCode: number;
     transactionId: string;
     event: SimplePayEvents;
@@ -87,7 +120,7 @@ declare interface SimplePayResult {
     tokens?: string[];
 }
 
-declare interface SimplePayTokenResponse extends Omit<SimplePayResponse, 'paymentUrl' | 'timeout'> {
+export declare interface SimplePayTokenResponse extends Omit<SimplePayResponse, 'paymentUrl' | 'timeout'> {
 }
 
 export declare const startPayment: (paymentData: PaymentData, config?: PaymentConfig) => Promise<SimplePayResponse>;

package/dist/index.js

@@ -1,31 +1,31 @@
 import S from "crypto";
-const d = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
+const _ = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
   process.env.SIMPLEPAY_LOGGER === "true" && console.log("👉 ", ...e);
 }, E = (e) => {
-  if (!d.includes(e))
+  if (!_.includes(e))
     throw new Error(`Unsupported currency: ${e}`);
-  const n = "https://secure.simplepay.hu/payment/v2", r = "https://sandbox.simplepay.hu/payment/v2", t = "SimplePay_Rrd_0.11.0", s = process.env[`SIMPLEPAY_MERCHANT_KEY_${e}`], c = process.env[`SIMPLEPAY_MERCHANT_ID_${e}`], o = process.env.SIMPLEPAY_PRODUCTION === "true" ? n : r, u = o + "/start", R = o + "/dorecurring", a = o + "/cardcancel";
+  const t = "https://secure.simplepay.hu/payment/v2", r = "https://sandbox.simplepay.hu/payment/v2", n = "SimplePay_Rrd_0.11.2", s = process.env[`SIMPLEPAY_MERCHANT_KEY_${e}`], c = process.env[`SIMPLEPAY_MERCHANT_ID_${e}`], o = process.env.SIMPLEPAY_PRODUCTION === "true" ? t : r, u = o + "/start", a = o + "/dorecurring", R = o + "/cardcancel";
   return {
     MERCHANT_KEY: s,
     MERCHANT_ID: c,
     API_URL_PAYMENT: u,
-    API_URL_RECURRING: R,
-    API_URL_CARD_CANCEL: a,
-    SDK_VERSION: t
+    API_URL_RECURRING: a,
+    API_URL_CARD_CANCEL: R,
+    SDK_VERSION: n
   };
-}, g = (e) => JSON.stringify(e).replace(/\//g, "\\/"), m = (e, n) => {
-  const r = S.createHmac("sha384", n.trim());
+}, g = (e) => JSON.stringify(e).replace(/\//g, "\\/"), m = (e, t) => {
+  const r = S.createHmac("sha384", t.trim());
   return r.update(e, "utf8"), r.digest("base64");
-}, _ = (e, n, r) => n === m(e, r), P = (e) => e.toISOString().replace(/\.\d{3}Z$/, "+00:00"), A = (e) => {
-  const n = Object.entries(process.env).find(
-    ([r, t]) => r.startsWith("SIMPLEPAY_MERCHANT_ID_") && t === e
+}, d = (e, t, r) => t === m(e, r), l = (e) => e.toISOString().replace(/\.\d{3}Z$/, "+00:00"), I = (e) => {
+  const t = Object.entries(process.env).find(
+    ([r, n]) => r.startsWith("SIMPLEPAY_MERCHANT_ID_") && n === e
   )?.[0]?.replace("SIMPLEPAY_MERCHANT_ID_", "");
-  if (!n)
+  if (!t)
     throw new Error(`Merchant id not found in the environment: ${e}`);
-  return n;
-}, p = async (e, n, r) => l(e, n, r, "oneTime"), I = async (e, n, r) => l(e, n, r, "recurring"), f = async (e, n, r) => l(e, n, r, "token"), h = async (e, n, r) => l(e, n, r, "cancelCard"), l = async (e, n, r, t) => {
-  const s = g(n), c = m(s, r);
-  i({ function: `SimplePay/makeRequest/${t}`, bodyString: s, signature: c });
+  return t;
+}, p = async (e, t, r) => P(e, t, r, "oneTime"), f = async (e, t, r) => P(e, t, r, "recurring"), A = async (e, t, r) => P(e, t, r, "token"), h = async (e, t, r) => P(e, t, r, "cancelCard"), P = async (e, t, r, n) => {
+  const s = g(t), c = m(s, r);
+  i({ function: `SimplePay/makeRequest/${n}`, bodyString: s, signature: c });
   try {
     const o = await fetch(e, {
       method: "POST",
@@ -35,25 +35,25 @@ const d = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
       },
       body: s
     });
-    if (i({ function: `SimplePay/makeRequest/${t}`, response: o }), !o.ok)
+    if (i({ function: `SimplePay/makeRequest/${n}`, response: o }), !o.ok)
       throw new Error(`SimplePay API error: ${o.status}`);
     const u = o.headers.get("Signature");
-    if (i({ function: `SimplePay/makeRequest/${t}`, responseSignature: u }), !u)
+    if (i({ function: `SimplePay/makeRequest/${n}`, responseSignature: u }), !u)
       throw new Error("Missing response signature");
-    const R = await o.text(), a = JSON.parse(R);
-    if (i({ function: `SimplePay/makeRequest/${t}`, responseText: R, responseJSON: a }), a.errorCodes)
-      throw new Error(`SimplePay API error: ${a.errorCodes}`);
-    if (!_(R, u, r))
+    const a = await o.text(), R = JSON.parse(a);
+    if (i({ function: `SimplePay/makeRequest/${n}`, responseText: a, responseJSON: R }), R.errorCodes)
+      throw new Error(`SimplePay API error: ${R.errorCodes}`);
+    if (!d(a, u, r))
       throw new Error("Invalid response signature");
-    return a;
+    return R;
   } catch (o) {
     throw o;
   }
-}, U = (e, n) => {
-  i({ function: "SimplePay/getPaymentResponse", r: e, signature: n }), n = decodeURIComponent(n);
-  const r = Buffer.from(e, "base64").toString("utf-8"), t = JSON.parse(r), s = A(t.m), { MERCHANT_KEY: c } = E(s);
-  if (!_(r, n, c || ""))
-    throw i({ function: "SimplePay/getPaymentResponse", rDecoded: r, signature: n }), new Error("Invalid response signature");
+}, w = (e, t) => {
+  i({ function: "SimplePay/getPaymentResponse", r: e, signature: t }), t = decodeURIComponent(t);
+  const r = Buffer.from(e, "base64").toString("utf-8"), n = JSON.parse(r), s = I(n.m), { MERCHANT_KEY: c } = E(s);
+  if (!d(r, t, c || ""))
+    throw i({ function: "SimplePay/getPaymentResponse", rDecoded: r, signature: t }), new Error("Invalid response signature");
   const o = JSON.parse(r);
   return {
     responseCode: o.r,
@@ -63,10 +63,22 @@ const d = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
     orderRef: o.o,
     tokens: o.tokens
   };
-}, w = async (e, n = {}) => {
+}, U = (e, t, r) => {
+  if (i({ function: "SimplePay/handleIpnRequest", ipnBody: e, incomingSignature: t }), !d(e, t, r))
+    throw new Error("Invalid IPN request signature");
+  JSON.parse(e);
+  const n = l(/* @__PURE__ */ new Date()), s = e.trim();
+  if (!s.endsWith("}"))
+    throw new Error("Invalid IPN body format");
+  const c = s.lastIndexOf("}"), o = s.substring(0, c).trim(), u = `"receiveDate":"${n}"`, a = o.length > 1 ? `${o},${u}}` : `{${u}}`, R = m(a, r);
+  return i({ function: "SimplePay/handleIpnRequest", responseBody: a, responseSignature: R }), {
+    responseBody: a,
+    signature: R
+  };
+}, L = async (e, t = {}) => {
   i({ function: "SimplePay/startPayment", paymentData: e });
-  const r = e.currency || "HUF", { MERCHANT_KEY: t, MERCHANT_ID: s, API_URL_PAYMENT: c, SDK_VERSION: o } = E(r);
-  if (i({ function: "SimplePay/startPayment", MERCHANT_KEY: t, MERCHANT_ID: s, API_URL_PAYMENT: c }), !t || !s)
+  const r = e.currency || "HUF", { MERCHANT_KEY: n, MERCHANT_ID: s, API_URL_PAYMENT: c, SDK_VERSION: o } = E(r);
+  if (i({ function: "SimplePay/startPayment", MERCHANT_KEY: n, MERCHANT_ID: s, API_URL_PAYMENT: c }), !n || !s)
     throw new Error(`Missing SimplePay configuration for ${r}`);
   const u = {
     salt: S.randomBytes(16).toString("hex"),
@@ -78,48 +90,48 @@ const d = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
     sdkVersion: o,
     methods: [e.method || "CARD"],
     total: String(e.total),
-    timeout: P(new Date(Date.now() + 1800 * 1e3)),
-    url: n.redirectUrl || process.env.SIMPLEPAY_REDIRECT_URL || "http://url.to.redirect",
+    timeout: l(new Date(Date.now() + 1800 * 1e3)),
+    url: t.redirectUrl || process.env.SIMPLEPAY_REDIRECT_URL || "http://url.to.redirect",
     invoice: e.invoice
   };
-  return p(c, u, t);
-}, y = 6, C = new Date(Date.now() + y * 30 * 24 * 60 * 60 * 1e3), M = 12e3, N = 3, L = async (e) => {
+  return p(c, u, n);
+}, y = 6, C = new Date(Date.now() + y * 30 * 24 * 60 * 60 * 1e3), N = 12e3, M = 3, H = async (e) => {
   i({ function: "SimplePay/startRecurringPayment", paymentData: e });
-  const n = e.currency || "HUF", { MERCHANT_KEY: r, MERCHANT_ID: t, API_URL_PAYMENT: s, SDK_VERSION: c } = E(n);
-  if (i({ function: "SimplePay/startRecurringPayment", MERCHANT_KEY: r, MERCHANT_ID: t, API_URL_PAYMENT: s }), !r || !t)
-    throw new Error(`Missing SimplePay configuration for ${n}`);
+  const t = e.currency || "HUF", { MERCHANT_KEY: r, MERCHANT_ID: n, API_URL_PAYMENT: s, SDK_VERSION: c } = E(t);
+  if (i({ function: "SimplePay/startRecurringPayment", MERCHANT_KEY: r, MERCHANT_ID: n, API_URL_PAYMENT: s }), !r || !n)
+    throw new Error(`Missing SimplePay configuration for ${t}`);
   const o = {
     salt: S.randomBytes(16).toString("hex"),
-    merchant: t,
+    merchant: n,
     orderRef: e.orderRef,
-    currency: n.replace("_SZEP", ""),
+    currency: t.replace("_SZEP", ""),
     customer: e.customer,
     customerEmail: e.customerEmail,
     language: e.language || "HU",
     sdkVersion: c,
     methods: ["CARD"],
     recurring: {
-      times: e.recurring.times || N,
-      until: e.recurring.until || P(C),
-      maxAmount: e.recurring.maxAmount || M
+      times: e.recurring.times || M,
+      until: e.recurring.until || l(C),
+      maxAmount: e.recurring.maxAmount || N
     },
     threeDSReqAuthMethod: "02",
     total: String(e.total),
-    timeout: P(new Date(Date.now() + 1800 * 1e3)),
+    timeout: l(new Date(Date.now() + 1800 * 1e3)),
     url: process.env.SIMPLEPAY_REDIRECT_URL || "http://url.to.redirect",
     invoice: e.invoice
   };
-  return I(s, o, r);
-}, H = async (e) => {
+  return f(s, o, r);
+}, v = async (e) => {
   i({ function: "SimplePay/startTokenPayment", paymentData: e });
-  const n = e.currency || "HUF", { MERCHANT_KEY: r, MERCHANT_ID: t, API_URL_RECURRING: s, SDK_VERSION: c } = E(n);
-  if (i({ function: "SimplePay/startTokenPayment", MERCHANT_KEY: r, MERCHANT_ID: t, API_URL_RECURRING: s }), !r || !t)
-    throw new Error(`Missing SimplePay configuration for ${n}`);
+  const t = e.currency || "HUF", { MERCHANT_KEY: r, MERCHANT_ID: n, API_URL_RECURRING: s, SDK_VERSION: c } = E(t);
+  if (i({ function: "SimplePay/startTokenPayment", MERCHANT_KEY: r, MERCHANT_ID: n, API_URL_RECURRING: s }), !r || !n)
+    throw new Error(`Missing SimplePay configuration for ${t}`);
   const o = {
     salt: S.randomBytes(16).toString("hex"),
-    merchant: t,
+    merchant: n,
     orderRef: e.orderRef,
-    currency: n.replace("_SZEP", ""),
+    currency: t.replace("_SZEP", ""),
     customer: e.customer,
     customerEmail: e.customerEmail,
     language: e.language || "HU",
@@ -129,32 +141,33 @@ const d = ["HUF", "HUF_SZEP", "EUR", "USD"], i = (...e) => {
     type: "MIT",
     threeDSReqAuthMethod: "02",
     total: String(e.total),
-    timeout: P(new Date(Date.now() + 1800 * 1e3)),
+    timeout: l(new Date(Date.now() + 1800 * 1e3)),
     url: process.env.SIMPLEPAY_REDIRECT_URL || "http://recurring.url.to.redirect",
     invoice: e.invoice
   };
-  return f(s, o, r);
+  return A(s, o, r);
 }, k = async (e) => {
   i({ function: "SimplePay/cancelCard", cardId: e });
-  const { API_URL_CARD_CANCEL: n, MERCHANT_KEY: r, MERCHANT_ID: t, SDK_VERSION: s } = E("HUF");
-  if (!r || !t)
+  const { API_URL_CARD_CANCEL: t, MERCHANT_KEY: r, MERCHANT_ID: n, SDK_VERSION: s } = E("HUF");
+  if (!r || !n)
     throw new Error("Missing SimplePay configuration for HUF");
   const c = {
     salt: S.randomBytes(16).toString("hex"),
     cardId: e,
-    merchant: t,
+    merchant: n,
     sdkVersion: s
   };
-  return h(n, c, r);
+  return h(t, c, r);
 };
 export {
   k as cancelCard,
-  _ as checkSignature,
+  d as checkSignature,
   m as generateSignature,
-  U as getPaymentResponse,
-  w as startPayment,
-  L as startRecurringPayment,
-  H as startTokenPayment,
-  P as toISO8601DateString
+  w as getPaymentResponse,
+  U as handleIpnRequest,
+  L as startPayment,
+  H as startRecurringPayment,
+  v as startTokenPayment,
+  l as toISO8601DateString
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/types.ts","../src/utils.ts","../src/oneTime.ts","../src/recurring.ts"],"sourcesContent":["export type PaymentMethod = 'CARD' | 'WIRE'\n\nexport const CURRENCIES = ['HUF', 'HUF_SZEP', 'EUR', 'USD'] as const\nexport type Currency = typeof CURRENCIES[number]\n\nexport const LANGUAGES = [\n    'AR', // Arabic\n    'BG', // Bulgarian\n    'CS', // Czech\n    'DE', // German\n    'EN', // English\n    'ES', // Spanish\n    'FR', // French\n    'IT', // Italian\n    'HR', // Croatian\n    'HU', // Hungarian\n    'PL', // Polish\n    'RO', // Romanian\n    'RU', // Russian\n    'SK', // Slovak\n    'TR', // Turkish\n    'ZH', // Chinese\n] as const\nexport type Language = typeof LANGUAGES[number]\n\nexport interface PaymentData {\n    orderRef: string\n    total: number | string\n    customerEmail: string\n    currency?: Currency\n    language?: Language\n    method?: PaymentMethod\n    invoice?: {\n        name: string\n        country: string\n        state: string\n        city: string\n        zip: string\n        address: string\n        address2?: string\n        phone?: string\n    }\n}\n\nexport interface PaymentConfig {\n    redirectUrl?: string\n}\n\nexport type ISO8601DateString = string\nexport interface Recurring {\n    times: number,\n    until: ISO8601DateString,\n    maxAmount: number\n}\nexport interface RecurringPaymentData extends PaymentData {\n    customer: string,\n    recurring: Recurring\n}\n\nexport interface TokenPaymentData extends Omit<PaymentData, 'method'> {\n    method: 'CARD',\n    customer: string,\n    token: string\n}\n\nexport interface SimplePayRequestBody extends Omit<PaymentData, 'total'> {\n    total: string\n    salt: string\n    merchant: string\n    sdkVersion: string\n    methods: PaymentMethod[]\n    timeout: string\n    url: string\n}\n\nexport interface SimplePayRecurringRequestBody extends SimplePayRequestBody {\n    customer: string\n    recurring: Recurring\n    threeDSReqAuthMethod: '02'  // only registered users can use this\n}\n\nexport interface SimplePayTokenRequestBody extends SimplePayRequestBody {\n    customer: string\n    token: string\n    threeDSReqAuthMethod: '02'  // only registered users can use this\n    type: 'MIT' // Merchant Initiated Transaction\n}\n\nexport interface SimplePayCancelCardRequestBody {\n    salt: string\n    cardId: string\n    merchant: string\n    sdkVersion: string\n}\n\nexport interface SimplePayResponse {\n    salt: string\n    merchant: string\n    orderRef: string\n    currency: Currency\n    transactionId: string\n    timeout: ISO8601DateString\n    total: string\n    paymentUrl: string\n    errorCodes?: string[]\n}\n\nexport interface SimplePayRecurringResponse extends SimplePayResponse {\n    tokens: string[]\n}\n\nexport interface SimplePayTokenResponse extends Omit<SimplePayResponse, 'paymentUrl' | 'timeout'> { }\n\nexport interface SimplePayCancelCardResponse {\n    salt: string\n    merchant: string\n    cardId: string\n    status: 'DISABLED'\n    expiry: string\n}\n\nexport type SimplePayEvents = 'SUCCESS' | 'FAIL' | 'TIMEOUT' | 'CANCEL'\n\nexport interface SimplePayAPIResult {\n    r: number   // response code\n    t: string   // transaction id\n    e: SimplePayEvents   // event\n    m: string   // merchant id\n    o: string   // order id\n}\n\nexport interface SimplePayResult {\n    responseCode: number,\n    transactionId: string,\n    event: SimplePayEvents,\n    merchantId: string,\n    orderRef: string,\n    tokens?: string[],\n}\n","import crypto from 'crypto'\nimport { CURRENCIES, Currency, ISO8601DateString, SimplePayAPIResult, SimplePayCancelCardRequestBody, SimplePayCancelCardResponse, SimplePayRecurringRequestBody, SimplePayRecurringResponse, SimplePayRequestBody, SimplePayResponse, SimplePayResult, SimplePayTokenRequestBody, SimplePayTokenResponse } from \"./types\"\n\nexport const simplepayLogger = (...args: any[]) => {\n    if (process.env.SIMPLEPAY_LOGGER !== 'true') {\n        return\n    }\n\n    console.log('👉 ', ...args)\n}\n\nexport const getSimplePayConfig = (currency: Currency) => {\n    if (!CURRENCIES.includes(currency)) {\n        throw new Error(`Unsupported currency: ${currency}`)\n    }\n\n    const SIMPLEPAY_API_URL = 'https://secure.simplepay.hu/payment/v2'\n    const SIMPLEPAY_SANDBOX_URL = 'https://sandbox.simplepay.hu/payment/v2'\n    const SDK_VERSION = 'SimplePay_Rrd_0.11.0'\n    const MERCHANT_KEY = process.env[`SIMPLEPAY_MERCHANT_KEY_${currency}`]\n    const MERCHANT_ID = process.env[`SIMPLEPAY_MERCHANT_ID_${currency}`]\n\n    const API_URL = process.env.SIMPLEPAY_PRODUCTION === 'true' ? SIMPLEPAY_API_URL : SIMPLEPAY_SANDBOX_URL\n    const API_URL_PAYMENT = API_URL + '/start'\n    const API_URL_RECURRING = API_URL + '/dorecurring'\n    const API_URL_CARD_CANCEL = API_URL + '/cardcancel'\n    return {\n        MERCHANT_KEY,\n        MERCHANT_ID,\n        API_URL_PAYMENT,\n        API_URL_RECURRING,\n        API_URL_CARD_CANCEL,\n        SDK_VERSION\n    }\n}\n\n// escaping slashes for the request body to prevent strange SimplePay API errors (eg Missing Signature)\nexport const prepareRequestBody = (body: any) =>\n    JSON.stringify(body).replace(/\\//g, '\\\\/')\n\nexport const generateSignature = (body: string, merchantKey: string) => {\n    const hmac = crypto.createHmac('sha384', merchantKey.trim())\n    hmac.update(body, 'utf8')\n    return hmac.digest('base64')\n}\n\nexport const checkSignature = (responseText: string, signature: string, merchantKey: string) =>\n    signature === generateSignature(responseText, merchantKey)\n\nexport const toISO8601DateString = (date: Date): ISO8601DateString => date.toISOString().replace(/\\.\\d{3}Z$/, '+00:00')\n\nexport const getCurrencyFromMerchantId = (merchantId: string) => {\n    const currency = Object.entries(process.env)\n        .find(([key, value]) =>\n            key.startsWith('SIMPLEPAY_MERCHANT_ID_') && value === merchantId\n        )?.[0]?.replace('SIMPLEPAY_MERCHANT_ID_', '') as Currency\n\n    if (!currency) {\n        throw new Error(`Merchant id not found in the environment: ${merchantId}`)\n    }\n\n    return currency\n}\n\nexport const makeSimplePayRequest = async (apiUrl: string, requestBody: SimplePayRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'oneTime') as Promise<SimplePayResponse>\n}\n\nexport const makeSimplePayRecurringRequest = async (apiUrl: string, requestBody: SimplePayRecurringRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'recurring') as Promise<SimplePayRecurringResponse>\n}\n\nexport const makeSimplePayTokenRequest = async (apiUrl: string, requestBody: SimplePayTokenRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'token') as Promise<SimplePayTokenResponse>\n}\n\nexport const makeSimplePayCancelCardRequest = async (apiUrl: string, requestBody: SimplePayCancelCardRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'cancelCard') as Promise<SimplePayCancelCardResponse>\n}\n\nconst makeRequest = async (apiUrl: string, requestBody: SimplePayRequestBody | SimplePayRecurringRequestBody | SimplePayTokenRequestBody | SimplePayCancelCardRequestBody, merchantKey: string, type: 'oneTime' | 'recurring' | 'token' | 'cancelCard') => {\n    const bodyString = prepareRequestBody(requestBody)\n    const signature = generateSignature(bodyString, merchantKey)\n    simplepayLogger({ function: `SimplePay/makeRequest/${type}`, bodyString, signature })\n\n    try {\n        const response = await fetch(apiUrl, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Signature': signature,\n            },\n            body: bodyString,\n        })\n\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, response })\n\n        if (!response.ok) {\n            throw new Error(`SimplePay API error: ${response.status}`)\n        }\n\n        const responseSignature = response.headers.get('Signature')\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, responseSignature })\n        if (!responseSignature) {\n            throw new Error('Missing response signature')\n        }\n\n        const responseText = await response.text()\n        const responseJSON = JSON.parse(responseText) as { errorCodes?: string[] }\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, responseText, responseJSON })\n\n        if (responseJSON.errorCodes) {\n            throw new Error(`SimplePay API error: ${responseJSON.errorCodes}`)\n        }\n\n        if (!checkSignature(responseText, responseSignature, merchantKey)) {\n            throw new Error('Invalid response signature')\n        }\n\n        return responseJSON\n\n    } catch (error) {\n        throw error\n    }\n}\n\nexport const getPaymentResponse = (r: string, signature: string) => {\n    simplepayLogger({ function: 'SimplePay/getPaymentResponse', r, signature })\n    signature = decodeURIComponent(signature)\n    const rDecoded = Buffer.from(r, 'base64').toString('utf-8')\n    const rDecodedJSON = JSON.parse(rDecoded) as SimplePayAPIResult\n    const currency = getCurrencyFromMerchantId(rDecodedJSON.m)\n    const { MERCHANT_KEY } = getSimplePayConfig(currency as Currency)\n\n    if (!checkSignature(rDecoded, signature, MERCHANT_KEY || '')) {\n        simplepayLogger({ function: 'SimplePay/getPaymentResponse', rDecoded, signature })\n        throw new Error('Invalid response signature')\n    }\n\n    const responseJson = JSON.parse(rDecoded)\n    const response: SimplePayResult = {\n        responseCode: responseJson.r,\n        transactionId: responseJson.t,\n        event: responseJson.e,\n        merchantId: responseJson.m,\n        orderRef: responseJson.o,\n        tokens: responseJson.tokens,\n    }\n\n    return response\n}\n","import crypto from 'crypto'\nimport { Currency, PaymentConfig, PaymentData, SimplePayRequestBody } from './types'\nimport { simplepayLogger, getSimplePayConfig, toISO8601DateString, makeSimplePayRequest } from './utils'\n\nconst startPayment = async (paymentData: PaymentData, config: PaymentConfig = {}) => {\n    simplepayLogger({ function: 'SimplePay/startPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: [paymentData.method || 'CARD'],\n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: config.redirectUrl || process.env.SIMPLEPAY_REDIRECT_URL || 'http://url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n    return makeSimplePayRequest(API_URL_PAYMENT, requestBody, MERCHANT_KEY)\n}\n\nexport { startPayment }\n","import crypto from 'crypto'\nimport { SimplePayRecurringRequestBody, RecurringPaymentData, TokenPaymentData, SimplePayTokenRequestBody, SimplePayCancelCardRequestBody, Currency} from './types'\nimport { getSimplePayConfig, simplepayLogger, toISO8601DateString, makeSimplePayTokenRequest, makeSimplePayRecurringRequest, makeSimplePayRequest, makeSimplePayCancelCardRequest} from './utils'\n\nconst INTERVAL_IN_MONTHS = 6\nconst DEFAULT_UNTIL = new Date(Date.now() + INTERVAL_IN_MONTHS * 30 * 24 * 60 * 60 * 1000)\nconst DEFAULT_MAX_AMOUNT = 12000\nconst DEFAULT_TIMES = 3\n\nconst startRecurringPayment = async (paymentData: RecurringPaymentData) => {\n    simplepayLogger({ function: 'SimplePay/startRecurringPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startRecurringPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayRecurringRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customer: paymentData.customer,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: ['CARD'],\n        recurring: {\n            times: paymentData.recurring.times || DEFAULT_TIMES,\n            until: paymentData.recurring.until || toISO8601DateString(DEFAULT_UNTIL),\n            maxAmount: paymentData.recurring.maxAmount || DEFAULT_MAX_AMOUNT\n        },\n        threeDSReqAuthMethod: '02', \n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: process.env.SIMPLEPAY_REDIRECT_URL || 'http://url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n   return makeSimplePayRecurringRequest(API_URL_PAYMENT, requestBody, MERCHANT_KEY)\n}\n\nconst startTokenPayment = async (paymentData: TokenPaymentData) => {\n    simplepayLogger({ function: 'SimplePay/startTokenPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_RECURRING, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startTokenPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_RECURRING })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayTokenRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customer: paymentData.customer,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: ['CARD'],\n        token: paymentData.token,\n        type: 'MIT',\n        threeDSReqAuthMethod: '02',\n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: process.env.SIMPLEPAY_REDIRECT_URL || 'http://recurring.url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n  return makeSimplePayTokenRequest(API_URL_RECURRING, requestBody, MERCHANT_KEY)\n}\n\nconst cancelCard = async (cardId: string) => {\n    simplepayLogger({ function: 'SimplePay/cancelCard', cardId })\n    const {API_URL_CARD_CANCEL, MERCHANT_KEY, MERCHANT_ID, SDK_VERSION} = getSimplePayConfig('HUF')\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for HUF`)\n    }\n\n    const requestBody: SimplePayCancelCardRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        cardId,\n        merchant: MERCHANT_ID,\n        sdkVersion: SDK_VERSION,\n    }\n    return makeSimplePayCancelCardRequest(API_URL_CARD_CANCEL, requestBody, MERCHANT_KEY)\n}\n\nexport { startRecurringPayment, startTokenPayment , cancelCard}\n"],"names":["CURRENCIES","simplepayLogger","args","getSimplePayConfig","currency","SIMPLEPAY_API_URL","SIMPLEPAY_SANDBOX_URL","SDK_VERSION","MERCHANT_KEY","MERCHANT_ID","API_URL","API_URL_PAYMENT","API_URL_RECURRING","API_URL_CARD_CANCEL","prepareRequestBody","body","generateSignature","merchantKey","hmac","crypto","checkSignature","responseText","signature","toISO8601DateString","date","getCurrencyFromMerchantId","merchantId","key","value","makeSimplePayRequest","apiUrl","requestBody","makeRequest","makeSimplePayRecurringRequest","makeSimplePayTokenRequest","makeSimplePayCancelCardRequest","type","bodyString","response","responseSignature","responseJSON","error","getPaymentResponse","r","rDecoded","rDecodedJSON","responseJson","startPayment","paymentData","config","INTERVAL_IN_MONTHS","DEFAULT_UNTIL","DEFAULT_MAX_AMOUNT","DEFAULT_TIMES","startRecurringPayment","startTokenPayment","cancelCard","cardId"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/types.ts","../src/utils.ts","../src/oneTime.ts","../src/recurring.ts"],"sourcesContent":["export type PaymentMethod = 'CARD' | 'WIRE'\n\nexport const CURRENCIES = ['HUF', 'HUF_SZEP', 'EUR', 'USD'] as const\nexport type Currency = typeof CURRENCIES[number]\n\nexport const LANGUAGES = [\n    'AR', // Arabic\n    'BG', // Bulgarian\n    'CS', // Czech\n    'DE', // German\n    'EN', // English\n    'ES', // Spanish\n    'FR', // French\n    'IT', // Italian\n    'HR', // Croatian\n    'HU', // Hungarian\n    'PL', // Polish\n    'RO', // Romanian\n    'RU', // Russian\n    'SK', // Slovak\n    'TR', // Turkish\n    'ZH', // Chinese\n] as const\nexport type Language = typeof LANGUAGES[number]\n\nexport interface PaymentData {\n    orderRef: string\n    total: number | string\n    customerEmail: string\n    currency?: Currency\n    language?: Language\n    method?: PaymentMethod\n    invoice?: {\n        name: string\n        country: string\n        state: string\n        city: string\n        zip: string\n        address: string\n        address2?: string\n        phone?: string\n    }\n}\n\nexport interface PaymentConfig {\n    redirectUrl?: string\n}\n\nexport type ISO8601DateString = string\nexport interface Recurring {\n    times: number,\n    until: ISO8601DateString,\n    maxAmount: number\n}\nexport interface RecurringPaymentData extends PaymentData {\n    customer: string,\n    recurring: Recurring\n}\n\nexport interface TokenPaymentData extends Omit<PaymentData, 'method'> {\n    method: 'CARD',\n    customer: string,\n    token: string\n}\n\nexport interface SimplePayRequestBody extends Omit<PaymentData, 'total'> {\n    total: string\n    salt: string\n    merchant: string\n    sdkVersion: string\n    methods: PaymentMethod[]\n    timeout: string\n    url: string\n}\n\nexport interface SimplePayRecurringRequestBody extends SimplePayRequestBody {\n    customer: string\n    recurring: Recurring\n    threeDSReqAuthMethod: '02'  // only registered users can use this\n}\n\nexport interface SimplePayTokenRequestBody extends SimplePayRequestBody {\n    customer: string\n    token: string\n    threeDSReqAuthMethod: '02'  // only registered users can use this\n    type: 'MIT' // Merchant Initiated Transaction\n}\n\nexport interface SimplePayCancelCardRequestBody {\n    salt: string\n    cardId: string\n    merchant: string\n    sdkVersion: string\n}\n\nexport interface SimplePayResponse {\n    salt: string\n    merchant: string\n    orderRef: string\n    currency: Currency\n    transactionId: string\n    timeout: ISO8601DateString\n    total: string\n    paymentUrl: string\n    errorCodes?: string[]\n}\n\nexport interface SimplePayRecurringResponse extends SimplePayResponse {\n    tokens: string[]\n}\n\nexport interface SimplePayTokenResponse extends Omit<SimplePayResponse, 'paymentUrl' | 'timeout'> { }\n\nexport interface SimplePayCancelCardResponse {\n    salt: string\n    merchant: string\n    cardId: string\n    status: 'DISABLED'\n    expiry: string\n}\n\nexport type SimplePayEvents = 'SUCCESS' | 'FAIL' | 'TIMEOUT' | 'CANCEL'\n\nexport interface SimplePayAPIResult {\n    r: number   // response code\n    t: string   // transaction id\n    e: SimplePayEvents   // event\n    m: string   // merchant id\n    o: string   // order id\n}\n\nexport interface SimplePayResult {\n    responseCode: number,\n    transactionId: string,\n    event: SimplePayEvents,\n    merchantId: string,\n    orderRef: string,\n    tokens?: string[],\n}\n","import crypto from 'crypto'\nimport { CURRENCIES, Currency, ISO8601DateString, SimplePayAPIResult, SimplePayCancelCardRequestBody, SimplePayCancelCardResponse, SimplePayRecurringRequestBody, SimplePayRecurringResponse, SimplePayRequestBody, SimplePayResponse, SimplePayResult, SimplePayTokenRequestBody, SimplePayTokenResponse } from \"./types\"\n\nexport const simplepayLogger = (...args: any[]) => {\n    if (process.env.SIMPLEPAY_LOGGER !== 'true') {\n        return\n    }\n\n    console.log('👉 ', ...args)\n}\n\nexport const getSimplePayConfig = (currency: Currency) => {\n    if (!CURRENCIES.includes(currency)) {\n        throw new Error(`Unsupported currency: ${currency}`)\n    }\n\n    const SIMPLEPAY_API_URL = 'https://secure.simplepay.hu/payment/v2'\n    const SIMPLEPAY_SANDBOX_URL = 'https://sandbox.simplepay.hu/payment/v2'\n    const SDK_VERSION = 'SimplePay_Rrd_0.11.2'\n    const MERCHANT_KEY = process.env[`SIMPLEPAY_MERCHANT_KEY_${currency}`]\n    const MERCHANT_ID = process.env[`SIMPLEPAY_MERCHANT_ID_${currency}`]\n\n    const API_URL = process.env.SIMPLEPAY_PRODUCTION === 'true' ? SIMPLEPAY_API_URL : SIMPLEPAY_SANDBOX_URL\n    const API_URL_PAYMENT = API_URL + '/start'\n    const API_URL_RECURRING = API_URL + '/dorecurring'\n    const API_URL_CARD_CANCEL = API_URL + '/cardcancel'\n    return {\n        MERCHANT_KEY,\n        MERCHANT_ID,\n        API_URL_PAYMENT,\n        API_URL_RECURRING,\n        API_URL_CARD_CANCEL,\n        SDK_VERSION\n    }\n}\n\n// escaping slashes for the request body to prevent strange SimplePay API errors (eg Missing Signature)\nexport const prepareRequestBody = (body: any) =>\n    JSON.stringify(body).replace(/\\//g, '\\\\/')\n\nexport const generateSignature = (body: string, merchantKey: string) => {\n    const hmac = crypto.createHmac('sha384', merchantKey.trim())\n    hmac.update(body, 'utf8')\n    return hmac.digest('base64')\n}\n\nexport const checkSignature = (responseText: string, signature: string, merchantKey: string) =>\n    signature === generateSignature(responseText, merchantKey)\n\nexport const toISO8601DateString = (date: Date): ISO8601DateString => date.toISOString().replace(/\\.\\d{3}Z$/, '+00:00')\n\nexport const getCurrencyFromMerchantId = (merchantId: string) => {\n    const currency = Object.entries(process.env)\n        .find(([key, value]) =>\n            key.startsWith('SIMPLEPAY_MERCHANT_ID_') && value === merchantId\n        )?.[0]?.replace('SIMPLEPAY_MERCHANT_ID_', '') as Currency\n\n    if (!currency) {\n        throw new Error(`Merchant id not found in the environment: ${merchantId}`)\n    }\n\n    return currency\n}\n\nexport const makeSimplePayRequest = async (apiUrl: string, requestBody: SimplePayRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'oneTime') as Promise<SimplePayResponse>\n}\n\nexport const makeSimplePayRecurringRequest = async (apiUrl: string, requestBody: SimplePayRecurringRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'recurring') as Promise<SimplePayRecurringResponse>\n}\n\nexport const makeSimplePayTokenRequest = async (apiUrl: string, requestBody: SimplePayTokenRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'token') as Promise<SimplePayTokenResponse>\n}\n\nexport const makeSimplePayCancelCardRequest = async (apiUrl: string, requestBody: SimplePayCancelCardRequestBody, merchantKey: string) => {\n    return makeRequest(apiUrl, requestBody, merchantKey, 'cancelCard') as Promise<SimplePayCancelCardResponse>\n}\n\nconst makeRequest = async (apiUrl: string, requestBody: SimplePayRequestBody | SimplePayRecurringRequestBody | SimplePayTokenRequestBody | SimplePayCancelCardRequestBody, merchantKey: string, type: 'oneTime' | 'recurring' | 'token' | 'cancelCard') => {\n    const bodyString = prepareRequestBody(requestBody)\n    const signature = generateSignature(bodyString, merchantKey)\n    simplepayLogger({ function: `SimplePay/makeRequest/${type}`, bodyString, signature })\n\n    try {\n        const response = await fetch(apiUrl, {\n            method: 'POST',\n            headers: {\n                'Content-Type': 'application/json',\n                'Signature': signature,\n            },\n            body: bodyString,\n        })\n\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, response })\n\n        if (!response.ok) {\n            throw new Error(`SimplePay API error: ${response.status}`)\n        }\n\n        const responseSignature = response.headers.get('Signature')\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, responseSignature })\n        if (!responseSignature) {\n            throw new Error('Missing response signature')\n        }\n\n        const responseText = await response.text()\n        const responseJSON = JSON.parse(responseText) as { errorCodes?: string[] }\n        simplepayLogger({ function: `SimplePay/makeRequest/${type}`, responseText, responseJSON })\n\n        if (responseJSON.errorCodes) {\n            throw new Error(`SimplePay API error: ${responseJSON.errorCodes}`)\n        }\n\n        if (!checkSignature(responseText, responseSignature, merchantKey)) {\n            throw new Error('Invalid response signature')\n        }\n\n        return responseJSON\n\n    } catch (error) {\n        throw error\n    }\n}\n\nexport const getPaymentResponse = (r: string, signature: string) => {\n    simplepayLogger({ function: 'SimplePay/getPaymentResponse', r, signature })\n    signature = decodeURIComponent(signature)\n    const rDecoded = Buffer.from(r, 'base64').toString('utf-8')\n    const rDecodedJSON = JSON.parse(rDecoded) as SimplePayAPIResult\n    const currency = getCurrencyFromMerchantId(rDecodedJSON.m)\n    const { MERCHANT_KEY } = getSimplePayConfig(currency as Currency)\n\n    if (!checkSignature(rDecoded, signature, MERCHANT_KEY || '')) {\n        simplepayLogger({ function: 'SimplePay/getPaymentResponse', rDecoded, signature })\n        throw new Error('Invalid response signature')\n    }\n\n    const responseJson = JSON.parse(rDecoded)\n    const response: SimplePayResult = {\n        responseCode: responseJson.r,\n        transactionId: responseJson.t,\n        event: responseJson.e,\n        merchantId: responseJson.m,\n        orderRef: responseJson.o,\n        tokens: responseJson.tokens,\n    }\n\n    return response\n}\n\n/**\n * Handles IPN (Instant Payment Notification) request and generates response\n * \n * This function implements the IPN flow according to SimplePay requirements:\n * 1. Validates the incoming signature\n * 2. Adds receiveDate property to the response\n * 3. Generates response signature\n * \n * @param ipnBody - The raw IPN request body as string (must be the exact string received, not parsed JSON)\n * @param incomingSignature - The signature from the 'Signature' HTTP header\n * @param merchantKey - The merchant secret key for signature validation and generation\n * @returns Object containing the response JSON string and signature to send back\n * \n * @example\n * // In your IPN endpoint handler:\n * const ipnBody = await request.text() // Get raw body as string\n * const incomingSignature = request.headers.get('Signature')\n * const { responseBody, signature } = handleIpnRequest(ipnBody, incomingSignature, MERCHANT_KEY)\n * \n * // Send response with HTTP 200 status\n * return new Response(responseBody, {\n *   status: 200,\n *   headers: {\n *     'Content-Type': 'application/json',\n *     'Signature': signature\n *   }\n * })\n */\nexport const handleIpnRequest = (ipnBody: string, incomingSignature: string, merchantKey: string) => {\n    simplepayLogger({ function: 'SimplePay/handleIpnRequest', ipnBody, incomingSignature })\n    \n    // Step 1: Validate incoming signature\n    if (!checkSignature(ipnBody, incomingSignature, merchantKey)) {\n        throw new Error('Invalid IPN request signature')\n    }\n    \n    // Step 2: Validate it's valid JSON (but don't use parsed object to preserve field order)\n    JSON.parse(ipnBody) // Just validate, don't use the result\n    \n    // Step 3: Add receiveDate to the original JSON string while preserving field order\n    // We insert receiveDate before the closing brace to maintain the original field order\n    // This ensures the field order in the response matches the original request\n    const receiveDate = toISO8601DateString(new Date())\n    const trimmedBody = ipnBody.trim()\n    \n    if (!trimmedBody.endsWith('}')) {\n        throw new Error('Invalid IPN body format')\n    }\n    \n    // Remove the closing brace, add receiveDate with comma, then add closing brace back\n    const lastBraceIndex = trimmedBody.lastIndexOf('}')\n    const beforeLastBrace = trimmedBody.substring(0, lastBraceIndex).trim()\n    const receiveDateJson = `\"receiveDate\":\"${receiveDate}\"`\n    \n    // Add comma before receiveDate if there's already content\n    const responseBody = beforeLastBrace.length > 1 \n        ? `${beforeLastBrace},${receiveDateJson}}`\n        : `{${receiveDateJson}}`\n    \n    // Step 4: Generate response signature using SHA384 HMAC + Base64\n    const responseSignature = generateSignature(responseBody, merchantKey)\n    \n    simplepayLogger({ function: 'SimplePay/handleIpnRequest', responseBody, responseSignature })\n    \n    return {\n        responseBody,\n        signature: responseSignature\n    }\n}\n","import crypto from 'crypto'\nimport { Currency, PaymentConfig, PaymentData, SimplePayRequestBody } from './types'\nimport { simplepayLogger, getSimplePayConfig, toISO8601DateString, makeSimplePayRequest } from './utils'\n\nconst startPayment = async (paymentData: PaymentData, config: PaymentConfig = {}) => {\n    simplepayLogger({ function: 'SimplePay/startPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: [paymentData.method || 'CARD'],\n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: config.redirectUrl || process.env.SIMPLEPAY_REDIRECT_URL || 'http://url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n    return makeSimplePayRequest(API_URL_PAYMENT, requestBody, MERCHANT_KEY)\n}\n\nexport { startPayment }\n","import crypto from 'crypto'\nimport { SimplePayRecurringRequestBody, RecurringPaymentData, TokenPaymentData, SimplePayTokenRequestBody, SimplePayCancelCardRequestBody, Currency} from './types'\nimport { getSimplePayConfig, simplepayLogger, toISO8601DateString, makeSimplePayTokenRequest, makeSimplePayRecurringRequest, makeSimplePayRequest, makeSimplePayCancelCardRequest} from './utils'\n\nconst INTERVAL_IN_MONTHS = 6\nconst DEFAULT_UNTIL = new Date(Date.now() + INTERVAL_IN_MONTHS * 30 * 24 * 60 * 60 * 1000)\nconst DEFAULT_MAX_AMOUNT = 12000\nconst DEFAULT_TIMES = 3\n\nconst startRecurringPayment = async (paymentData: RecurringPaymentData) => {\n    simplepayLogger({ function: 'SimplePay/startRecurringPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startRecurringPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_PAYMENT })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayRecurringRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customer: paymentData.customer,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: ['CARD'],\n        recurring: {\n            times: paymentData.recurring.times || DEFAULT_TIMES,\n            until: paymentData.recurring.until || toISO8601DateString(DEFAULT_UNTIL),\n            maxAmount: paymentData.recurring.maxAmount || DEFAULT_MAX_AMOUNT\n        },\n        threeDSReqAuthMethod: '02', \n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: process.env.SIMPLEPAY_REDIRECT_URL || 'http://url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n   return makeSimplePayRecurringRequest(API_URL_PAYMENT, requestBody, MERCHANT_KEY)\n}\n\nconst startTokenPayment = async (paymentData: TokenPaymentData) => {\n    simplepayLogger({ function: 'SimplePay/startTokenPayment', paymentData })\n    const currency = paymentData.currency || 'HUF'\n    const { MERCHANT_KEY, MERCHANT_ID, API_URL_RECURRING, SDK_VERSION } = getSimplePayConfig(currency)\n    simplepayLogger({ function: 'SimplePay/startTokenPayment', MERCHANT_KEY, MERCHANT_ID, API_URL_RECURRING })\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for ${currency}`)\n    }\n\n    const requestBody: SimplePayTokenRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        merchant: MERCHANT_ID,\n        orderRef: paymentData.orderRef,\n        currency: currency.replace('_SZEP', '') as Currency,\n        customer: paymentData.customer,\n        customerEmail: paymentData.customerEmail,\n        language: paymentData.language || 'HU',\n        sdkVersion: SDK_VERSION,\n        methods: ['CARD'],\n        token: paymentData.token,\n        type: 'MIT',\n        threeDSReqAuthMethod: '02',\n        total: String(paymentData.total),\n        timeout: toISO8601DateString(new Date(Date.now() + 30 * 60 * 1000)),\n        url: process.env.SIMPLEPAY_REDIRECT_URL || 'http://recurring.url.to.redirect',\n        invoice: paymentData.invoice,\n    }\n\n  return makeSimplePayTokenRequest(API_URL_RECURRING, requestBody, MERCHANT_KEY)\n}\n\nconst cancelCard = async (cardId: string) => {\n    simplepayLogger({ function: 'SimplePay/cancelCard', cardId })\n    const {API_URL_CARD_CANCEL, MERCHANT_KEY, MERCHANT_ID, SDK_VERSION} = getSimplePayConfig('HUF')\n\n    if (!MERCHANT_KEY || !MERCHANT_ID) {\n        throw new Error(`Missing SimplePay configuration for HUF`)\n    }\n\n    const requestBody: SimplePayCancelCardRequestBody = {\n        salt: crypto.randomBytes(16).toString('hex'),\n        cardId,\n        merchant: MERCHANT_ID,\n        sdkVersion: SDK_VERSION,\n    }\n    return makeSimplePayCancelCardRequest(API_URL_CARD_CANCEL, requestBody, MERCHANT_KEY)\n}\n\nexport { startRecurringPayment, startTokenPayment , cancelCard}\n"],"names":["CURRENCIES","simplepayLogger","args","getSimplePayConfig","currency","SIMPLEPAY_API_URL","SIMPLEPAY_SANDBOX_URL","SDK_VERSION","MERCHANT_KEY","MERCHANT_ID","API_URL","API_URL_PAYMENT","API_URL_RECURRING","API_URL_CARD_CANCEL","prepareRequestBody","body","generateSignature","merchantKey","hmac","crypto","checkSignature","responseText","signature","toISO8601DateString","date","getCurrencyFromMerchantId","merchantId","key","value","makeSimplePayRequest","apiUrl","requestBody","makeRequest","makeSimplePayRecurringRequest","makeSimplePayTokenRequest","makeSimplePayCancelCardRequest","type","bodyString","response","responseSignature","responseJSON","error","getPaymentResponse","r","rDecoded","rDecodedJSON","responseJson","handleIpnRequest","ipnBody","incomingSignature","receiveDate","trimmedBody","lastBraceIndex","beforeLastBrace","receiveDateJson","responseBody","startPayment","paymentData","config","INTERVAL_IN_MONTHS","DEFAULT_UNTIL","DEFAULT_MAX_AMOUNT","DEFAULT_TIMES","startRecurringPayment","startTokenPayment","cancelCard","cardId"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simplepay-js-sdk",
-  "version": "0.11.1",
+  "version": "0.12.0",
   "description": "A Node.js utility for SimplePay payment integration",
   "repository": {
     "type": "git",

package/src/index.ts

@@ -1,11 +1,12 @@
 import { startPayment } from './oneTime'
 import { startRecurringPayment, startTokenPayment, cancelCard} from './recurring'
-import type { Currency, Language, PaymentMethod } from './types'
-import { checkSignature, generateSignature, getPaymentResponse, toISO8601DateString } from './utils'
+import type { Currency, Language, PaymentMethod, SimplePayResponse, SimplePayRecurringResponse, SimplePayTokenResponse, SimplePayCancelCardResponse, SimplePayResult } from './types'
+import { checkSignature, generateSignature, getPaymentResponse, handleIpnRequest, toISO8601DateString } from './utils'
 
 export {
     Currency, Language, PaymentMethod,
-    checkSignature, generateSignature, toISO8601DateString, getPaymentResponse,
+    SimplePayResponse, SimplePayRecurringResponse, SimplePayTokenResponse, SimplePayCancelCardResponse, SimplePayResult,
+    checkSignature, generateSignature, toISO8601DateString, getPaymentResponse, handleIpnRequest,
     startPayment,     
     startRecurringPayment, startTokenPayment, cancelCard
 }

package/src/utils.spec.ts

@@ -1,6 +1,6 @@
 import { describe, it, expect, beforeEach } from 'vitest'
 import { Currency } from './types'
-import { checkSignature, generateSignature, getCurrencyFromMerchantId, getSimplePayConfig } from './utils'
+import { checkSignature, generateSignature, getCurrencyFromMerchantId, getSimplePayConfig, handleIpnRequest } from './utils'
 
 const setEnv = () => {
     process.env.SIMPLEPAY_MERCHANT_ID_HUF = 'testId'
@@ -140,4 +140,184 @@ describe('SimplePay Utils Tests', () => {
             expect(currencySzep).toBe('HUF_SZEP')
         })
     })
+
+    describe('IPN Response Signature', () => {
+        it('should generate valid signature for IPN response after adding receiveDate', () => {
+            setEnv()
+            const merchantKey = 'testKey'
+            
+            // Simulate incoming IPN request body (compact JSON, no whitespace)
+            const ipnRequestBody = {
+                r: 0,
+                t: '504233881',
+                e: 'SUCCESS',
+                m: 'testId',
+                o: 'test-order-123'
+            }
+            
+            // JSON.stringify produces compact JSON by default (no whitespace)
+            const ipnBodyString = JSON.stringify(ipnRequestBody)
+            
+            // Generate valid incoming signature (as if from SimplePay)
+            const incomingSignature = generateSignature(ipnBodyString, merchantKey)
+            
+            // Step 1: Verify incoming signature is valid
+            const isIncomingSignatureValid = checkSignature(ipnBodyString, incomingSignature, merchantKey)
+            expect(isIncomingSignatureValid).toBeTruthy()
+            
+            // Step 2: Add receiveDate property (as per IPN flow)
+            const ipnResponseBody = {
+                ...ipnRequestBody,
+                receiveDate: new Date().toISOString().replace(/\.\d{3}Z$/, '+00:00')
+            }
+            
+            // JSON.stringify produces compact JSON (no whitespace) - required by SimplePay
+            const ipnResponseBodyString = JSON.stringify(ipnResponseBody)
+            
+            // Step 3: Generate response signature
+            const responseSignature = generateSignature(ipnResponseBodyString, merchantKey)
+            
+            // Step 4: Verify the response signature is valid
+            const isResponseSignatureValid = checkSignature(ipnResponseBodyString, responseSignature, merchantKey)
+            expect(isResponseSignatureValid).toBeTruthy()
+            
+            // Verify response signature is different from incoming signature (since body changed)
+            expect(responseSignature).not.toBe(incomingSignature)
+            
+            // Verify JSON is compact (no whitespace)
+            expect(ipnResponseBodyString).not.toMatch(/\s/)
+        })
+
+        it('should handle IPN request using handleIpnRequest function', () => {
+            setEnv()
+            const merchantKey = 'testKey'
+            
+            // Simulate incoming IPN request body (compact JSON, no whitespace)
+            // Use a specific field order to test that it's preserved
+            const ipnBodyString = '{"r":0,"t":"504233881","e":"SUCCESS","m":"testId","o":"test-order-123"}'
+            const incomingSignature = generateSignature(ipnBodyString, merchantKey)
+            
+            // Use handleIpnRequest function
+            const { responseBody, signature } = handleIpnRequest(ipnBodyString, incomingSignature, merchantKey)
+            
+            // Verify response contains receiveDate
+            const responseData = JSON.parse(responseBody)
+            expect(responseData).toHaveProperty('receiveDate')
+            expect(responseData.r).toBe(0)
+            expect(responseData.t).toBe('504233881')
+            expect(responseData.e).toBe('SUCCESS')
+            expect(responseData.m).toBe('testId')
+            expect(responseData.o).toBe('test-order-123')
+            
+            // Verify response signature is valid
+            const isSignatureValid = checkSignature(responseBody, signature, merchantKey)
+            expect(isSignatureValid).toBeTruthy()
+            
+            // Verify JSON is compact (no whitespace) - required by SimplePay
+            expect(responseBody).not.toMatch(/\s/)
+            
+            // Verify receiveDate is in ISO 8601 format (e.g., 2025-10-06T07:00:34+02:00)
+            expect(responseData.receiveDate).toMatch(/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}[+-]\d{2}:\d{2}$/)
+            
+            // Verify field order is preserved: original fields come first, receiveDate is last
+            const responseBodyString = responseBody
+            expect(responseBodyString).toMatch(/^\{.*"r":0,.*"t":".*",.*"e":".*",.*"m":".*",.*"o":".*",.*"receiveDate":".*"\}$/)
+            // Verify receiveDate is the last field before closing brace
+            expect(responseBodyString).toMatch(/"receiveDate":"[^"]*"\}$/)
+        })
+
+        it('should preserve field order in IPN response', () => {
+            setEnv()
+            const merchantKey = 'testKey'
+            
+            // Test with a specific field order
+            const ipnBodyString = '{"r":0,"t":"123","e":"SUCCESS","m":"merchantId","o":"order123"}'
+            const incomingSignature = generateSignature(ipnBodyString, merchantKey)
+            
+            const { responseBody } = handleIpnRequest(ipnBodyString, incomingSignature, merchantKey)
+            
+            // Verify the original fields are in the same order
+            const rIndex = responseBody.indexOf('"r":')
+            const tIndex = responseBody.indexOf('"t":')
+            const eIndex = responseBody.indexOf('"e":')
+            const mIndex = responseBody.indexOf('"m":')
+            const oIndex = responseBody.indexOf('"o":')
+            const receiveDateIndex = responseBody.indexOf('"receiveDate":')
+            
+            // Verify order: r < t < e < m < o < receiveDate
+            expect(rIndex).toBeLessThan(tIndex)
+            expect(tIndex).toBeLessThan(eIndex)
+            expect(eIndex).toBeLessThan(mIndex)
+            expect(mIndex).toBeLessThan(oIndex)
+            expect(oIndex).toBeLessThan(receiveDateIndex)
+            
+            // Verify receiveDate is the last field
+            const lastFieldIndex = Math.max(rIndex, tIndex, eIndex, mIndex, oIndex, receiveDateIndex)
+            expect(lastFieldIndex).toBe(receiveDateIndex)
+        })
+
+        it('should throw error for invalid incoming IPN signature', () => {
+            setEnv()
+            const merchantKey = 'testKey'
+            
+            const ipnBodyString = JSON.stringify({ r: 0, t: '123', e: 'SUCCESS', m: 'testId', o: 'test-order' })
+            const invalidSignature = 'invalid-signature'
+            
+            expect(() => {
+                handleIpnRequest(ipnBodyString, invalidSignature, merchantKey)
+            }).toThrow('Invalid IPN request signature')
+        })
+
+        it('should generate valid signature for IPN response with different currencies', () => {
+            setEnv()
+            
+            const testCases = [
+                { currency: 'HUF' as Currency, merchantKey: 'testKey', merchantId: 'testId' },
+                { currency: 'EUR' as Currency, merchantKey: 'secretEuroKey', merchantId: 'merchantEuroId' },
+                { currency: 'HUF_SZEP' as Currency, merchantKey: 'testKeySzep', merchantId: 'testIdSzep' }
+            ]
+            
+            testCases.forEach(({ currency, merchantKey, merchantId }) => {
+                // Use specific field order to test preservation
+                const ipnBodyString = `{"r":0,"t":"504233881","e":"SUCCESS","m":"${merchantId}","o":"test-order-${currency}"}`
+                const incomingSignature = generateSignature(ipnBodyString, merchantKey)
+                
+                // Verify incoming signature
+                expect(checkSignature(ipnBodyString, incomingSignature, merchantKey)).toBeTruthy()
+                
+                // Use handleIpnRequest function
+                const { responseBody, signature } = handleIpnRequest(ipnBodyString, incomingSignature, merchantKey)
+                
+                // Verify response signature
+                expect(checkSignature(responseBody, signature, merchantKey)).toBeTruthy()
+                
+                // Verify JSON is compact (no whitespace)
+                expect(responseBody).not.toMatch(/\s/)
+                
+                // Verify field order is preserved
+                expect(responseBody).toMatch(/^\{.*"r":0,.*"t":".*",.*"e":".*",.*"m":".*",.*"o":".*",.*"receiveDate":".*"\}$/)
+            })
+        })
+
+        it('should reject IPN response with invalid signature', () => {
+            setEnv()
+            const merchantKey = 'testKey'
+            
+            const ipnRequestBody = {
+                r: 0,
+                t: '504233881',
+                e: 'SUCCESS',
+                m: 'testId',
+                o: 'test-order-123',
+                receiveDate: new Date().toISOString().replace(/\.\d{3}Z$/, '+00:00')
+            }
+            
+            // JSON.stringify produces compact JSON (no whitespace)
+            const ipnResponseBodyString = JSON.stringify(ipnRequestBody)
+            const invalidSignature = 'invalid-signature'
+            
+            const isValid = checkSignature(ipnResponseBodyString, invalidSignature, merchantKey)
+            expect(isValid).toBeFalsy()
+        })
+    })
 })

package/src/utils.ts

@@ -16,7 +16,7 @@ export const getSimplePayConfig = (currency: Currency) => {
 
     const SIMPLEPAY_API_URL = 'https://secure.simplepay.hu/payment/v2'
     const SIMPLEPAY_SANDBOX_URL = 'https://sandbox.simplepay.hu/payment/v2'
-    const SDK_VERSION = 'SimplePay_Rrd_0.11.1'
+    const SDK_VERSION = 'SimplePay_Rrd_0.12.0'
     const MERCHANT_KEY = process.env[`SIMPLEPAY_MERCHANT_KEY_${currency}`]
     const MERCHANT_ID = process.env[`SIMPLEPAY_MERCHANT_ID_${currency}`]
 
@@ -149,3 +149,73 @@ export const getPaymentResponse = (r: string, signature: string) => {
 
     return response
 }
+
+/**
+ * Handles IPN (Instant Payment Notification) request and generates response
+ * 
+ * This function implements the IPN flow according to SimplePay requirements:
+ * 1. Validates the incoming signature
+ * 2. Adds receiveDate property to the response
+ * 3. Generates response signature
+ * 
+ * @param ipnBody - The raw IPN request body as string (must be the exact string received, not parsed JSON)
+ * @param incomingSignature - The signature from the 'Signature' HTTP header
+ * @param merchantKey - The merchant secret key for signature validation and generation
+ * @returns Object containing the response JSON string and signature to send back
+ * 
+ * @example
+ * // In your IPN endpoint handler:
+ * const ipnBody = await request.text() // Get raw body as string
+ * const incomingSignature = request.headers.get('Signature')
+ * const { responseBody, signature } = handleIpnRequest(ipnBody, incomingSignature, MERCHANT_KEY)
+ * 
+ * // Send response with HTTP 200 status
+ * return new Response(responseBody, {
+ *   status: 200,
+ *   headers: {
+ *     'Content-Type': 'application/json',
+ *     'Signature': signature
+ *   }
+ * })
+ */
+export const handleIpnRequest = (ipnBody: string, incomingSignature: string, merchantKey: string) => {
+    simplepayLogger({ function: 'SimplePay/handleIpnRequest', ipnBody, incomingSignature })
+    
+    // Step 1: Validate incoming signature
+    if (!checkSignature(ipnBody, incomingSignature, merchantKey)) {
+        throw new Error('Invalid IPN request signature')
+    }
+    
+    // Step 2: Validate it's valid JSON (but don't use parsed object to preserve field order)
+    JSON.parse(ipnBody) // Just validate, don't use the result
+    
+    // Step 3: Add receiveDate to the original JSON string while preserving field order
+    // We insert receiveDate before the closing brace to maintain the original field order
+    // This ensures the field order in the response matches the original request
+    const receiveDate = toISO8601DateString(new Date())
+    const trimmedBody = ipnBody.trim()
+    
+    if (!trimmedBody.endsWith('}')) {
+        throw new Error('Invalid IPN body format')
+    }
+    
+    // Remove the closing brace, add receiveDate with comma, then add closing brace back
+    const lastBraceIndex = trimmedBody.lastIndexOf('}')
+    const beforeLastBrace = trimmedBody.substring(0, lastBraceIndex).trim()
+    const receiveDateJson = `"receiveDate":"${receiveDate}"`
+    
+    // Add comma before receiveDate if there's already content
+    const responseBody = beforeLastBrace.length > 1 
+        ? `${beforeLastBrace},${receiveDateJson}}`
+        : `{${receiveDateJson}}`
+    
+    // Step 4: Generate response signature using SHA384 HMAC + Base64
+    const responseSignature = generateSignature(responseBody, merchantKey)
+    
+    simplepayLogger({ function: 'SimplePay/handleIpnRequest', responseBody, responseSignature })
+    
+    return {
+        responseBody,
+        signature: responseSignature
+    }
+}