@reevit/react 0.7.0 → 0.8.0

package/dist/index.d.mts

@@ -183,6 +183,8 @@ interface PaymentIntent {
     recommendedPsp: 'paystack' | 'hubtel' | 'flutterwave' | 'monnify' | 'mpesa' | 'stripe';
     /** Available payment methods for this intent */
     availableMethods: PaymentMethod[];
+    /** Provider transaction reference returned by Reevit */
+    providerRefId?: string;
     /** Reference provided or generated */
     reference?: string;
     /** Organization ID (from Reevit backend, required for webhook routing) */
@@ -361,6 +363,7 @@ declare function openHubtelPopup(config: {
     amount: number;
     clientReference?: string;
     callbackUrl?: string;
+    apiBaseUrl?: string;
     customerPhoneNumber?: string;
     basicAuth?: string;
     preferredMethod?: PaymentMethod;
@@ -623,6 +626,7 @@ interface PaymentIntentResponse {
     org_id?: string;
     connection_id: string;
     provider: string;
+    provider_ref_id?: string;
     status: string;
     client_secret: string;
     psp_public_key?: string;

package/dist/index.d.ts

@@ -183,6 +183,8 @@ interface PaymentIntent {
     recommendedPsp: 'paystack' | 'hubtel' | 'flutterwave' | 'monnify' | 'mpesa' | 'stripe';
     /** Available payment methods for this intent */
     availableMethods: PaymentMethod[];
+    /** Provider transaction reference returned by Reevit */
+    providerRefId?: string;
     /** Reference provided or generated */
     reference?: string;
     /** Organization ID (from Reevit backend, required for webhook routing) */
@@ -361,6 +363,7 @@ declare function openHubtelPopup(config: {
     amount: number;
     clientReference?: string;
     callbackUrl?: string;
+    apiBaseUrl?: string;
     customerPhoneNumber?: string;
     basicAuth?: string;
     preferredMethod?: PaymentMethod;
@@ -623,6 +626,7 @@ interface PaymentIntentResponse {
     org_id?: string;
     connection_id: string;
     provider: string;
+    provider_ref_id?: string;
     status: string;
     client_secret: string;
     psp_public_key?: string;

package/dist/index.js

@@ -515,8 +515,9 @@ function mapToPaymentIntent(response, config) {
     status: response.status,
     recommendedPsp: mapProviderToPsp(response.provider),
     availableMethods: config.paymentMethods || ["card", "mobile_money"],
-    reference: response.reference || response.id,
-    // Use backend reference or fallback to ID
+    providerRefId: response.provider_ref_id,
+    reference: response.reference || response.provider_ref_id || response.id,
+    // Use backend reference or fallback to provider ref then ID
     orgId: response.org_id,
     connectionId: response.connection_id,
     provider: response.provider,
@@ -1337,6 +1338,38 @@ function PaystackBridge({
     /* @__PURE__ */ jsxRuntime.jsx("p", { children: "Connecting to Paystack..." })
   ] }) });
 }
+var DEFAULT_REEVIT_API_BASE_URL = "https://api.reevit.io";
+function getHubtelCallbackURL(apiBaseUrl) {
+  return `${apiBaseUrl || DEFAULT_REEVIT_API_BASE_URL}/v1/webhooks/incoming/hubtel`;
+}
+function parseHubtelCallbackPayload(input) {
+  if (!input || typeof input !== "object") {
+    return {};
+  }
+  const raw = input;
+  const nested = raw.data;
+  if (typeof nested === "string") {
+    try {
+      const parsed = JSON.parse(nested);
+      if (parsed && typeof parsed === "object") {
+        return { ...raw, ...parsed };
+      }
+    } catch {
+    }
+  } else if (nested && typeof nested === "object") {
+    return { ...raw, ...nested };
+  }
+  return raw;
+}
+function readHubtelField(payload, keys) {
+  for (const key of keys) {
+    const value = payload[key];
+    if (typeof value === "string" && value.trim().length > 0) {
+      return value.trim();
+    }
+  }
+  return "";
+}
 function HubtelBridge({
   paymentId,
   publicKey,
@@ -1413,12 +1446,12 @@ function HubtelBridge({
         purchaseDescription: description,
         customerPhoneNumber: phone || "",
         ...email ? { customerEmail: email } : {},
-        clientReference: reference || `hubtel_${Date.now()}`,
+        clientReference: reference || paymentId || `hubtel_${Date.now()}`,
         ...methodPreference ? { paymentMethod: methodPreference } : {}
       };
       const config = {
         branding: "enabled",
-        callbackUrl: callbackUrl || window.location.href,
+        callbackUrl: callbackUrl || getHubtelCallbackURL(apiBaseUrl),
         merchantAccount: typeof resolvedMerchantAccount === "string" ? parseInt(resolvedMerchantAccount, 10) : resolvedMerchantAccount,
         basicAuth: authValue || "",
         ...methodPreference ? { paymentMethod: methodPreference } : {}
@@ -1429,24 +1462,41 @@ function HubtelBridge({
         callBacks: {
           onInit: () => console.log("Hubtel checkout initialized"),
           onPaymentSuccess: (data) => {
+            const payload = parseHubtelCallbackPayload(data);
+            const transactionReference = readHubtelField(payload, [
+              "transactionId",
+              "transaction_id",
+              "transactionReference",
+              "paymentReference",
+              "checkoutId"
+            ]);
+            const clientReference = readHubtelField(payload, ["clientReference", "client_reference"]);
             const result = {
-              paymentId: data.transactionId || reference || "",
-              reference: data.clientReference || reference || "",
+              paymentId,
+              reference: clientReference || reference || paymentId,
               amount,
               currency: currency || "GHS",
               paymentMethod: preferredMethod || "mobile_money",
               psp: "hubtel",
-              pspReference: data.transactionId || "",
-              status: "success"
+              pspReference: transactionReference || paymentId,
+              status: "success",
+              metadata: {
+                hubtel_payload: payload,
+                hubtel_raw: data
+              }
             };
             onSuccess(result);
             checkout.closePopUp();
           },
           onPaymentFailure: (data) => {
+            const payload = parseHubtelCallbackPayload(data);
             const error = {
               code: "PAYMENT_FAILED",
-              message: data.message || "Payment failed",
-              recoverable: true
+              message: readHubtelField(payload, ["message", "error", "reason"]) || "Payment failed",
+              recoverable: true,
+              details: {
+                hubtel_payload: payload
+              }
             };
             onError(error);
           },
@@ -1471,6 +1521,8 @@ function HubtelBridge({
     phone,
     description,
     callbackUrl,
+    paymentId,
+    apiBaseUrl,
     authValue,
     isLoading,
     preferredMethod,
@@ -1503,7 +1555,7 @@ function openHubtelPopup(config) {
   };
   const checkoutConfig = {
     branding: "enabled",
-    callbackUrl: config.callbackUrl || window.location.href,
+    callbackUrl: config.callbackUrl || getHubtelCallbackURL(config.apiBaseUrl),
     merchantAccount: typeof config.merchantAccount === "string" ? parseInt(config.merchantAccount, 10) : config.merchantAccount,
     basicAuth: config.basicAuth || "",
     ...methodPreference ? { paymentMethod: methodPreference } : {}
@@ -1513,11 +1565,11 @@ function openHubtelPopup(config) {
     config: checkoutConfig,
     callBacks: {
       onPaymentSuccess: (data) => {
-        config.onSuccess?.(data);
+        config.onSuccess?.(parseHubtelCallbackPayload(data));
         checkout.closePopUp();
       },
       onPaymentFailure: (data) => {
-        config.onError?.(data);
+        config.onError?.(parseHubtelCallbackPayload(data));
       },
       onClose: () => {
         config.onClose?.();
@@ -2577,10 +2629,11 @@ function ReevitCheckout({
               merchantAccount: paymentIntent?.pspCredentials?.merchantAccount || "",
               amount: paymentIntent?.amount ?? amount,
               currency: paymentIntent?.currency ?? currency,
-              reference: paymentIntent?.reference || reference,
+              reference: paymentIntent?.providerRefId || paymentIntent?.reference || reference,
               email,
               phone: momoData?.phone || phone,
               description: `Payment ${paymentIntent?.reference || reference || ""}`,
+              callbackUrl: `${apiBaseUrl || "https://api.reevit.io"}/v1/webhooks/incoming/hubtel`,
               hubtelSessionToken: paymentIntent?.id ? paymentIntent.id : void 0,
               clientSecret: paymentIntent?.clientSecret,
               apiBaseUrl,