@yosle/tropipayjs 0.2.1 → 0.2.2

package/interfaces/index.d.ts

@@ -35,71 +35,36 @@ export interface UserHookSubscribed extends UserHook {
     createdAt: string;
     updatedAt: string;
 }
-/**
- * Interface for creating payment links/cards
- * @see https://tpp.stoplight.io/docs/tropipay-api-doc/b3A6ODgyNTM3OQ-create-a-new-pay-link-charge
- */
 export interface PaymentLinkPayload {
-    /** Account ID where the funds will be received if compatible */
-    accountId?: number;
-    /** Reference code for the payment, preferred to be unique */
     reference: string;
-    /** Short description of the payment */
     concept: string;
-    /** Whether to mark this payment link as favorite */
     favorite: boolean;
-    /** Amount to charge in the specified currency */
     amount: number;
-    /** Currency code (EUR, USD, etc.) */
     currency: string;
-    /** Detailed description of the payment */
     description: string;
-    /** If true, the payment link can only be used once */
     singleUse: boolean;
-    /** Reason ID for the payment */
     reasonId: number;
-    /** Number of days until the payment link expires */
     expirationDays: number;
-    /** Language code for the payment page (en, es, etc.) */
     lang: string;
-    /** URL to redirect after successful payment */
     urlSuccess: string;
-    /** URL to redirect after failed payment */
     urlFailed: string;
-    /** Webhook URL for payment notifications */
     urlNotification: string;
-    /** Date when the service will be provided (ISO format) */
     serviceDate: string;
-    /** Client information for the payment */
     client?: {
-        /** Client's first name */
         name?: string;
-        /** Client's last name */
         lastName?: string;
-        /** Client's address */
         address?: string;
-        /** Client's phone number */
         phone?: string;
-        /** Client's email address */
         email?: string;
-        /** Client's country ID */
         countryId?: number;
-        /** Client's country ISO code */
         countryIso?: string;
-        /** Client's city */
         city: string;
-        /** Client's postal code */
         postCode: string;
-        /** Whether client accepted terms and conditions */
         termsAndConditions: boolean;
     } | null;
-    /** @deprecated If true, redirects directly to payment page */
     directPayment: boolean;
-    /** List of allowed payment methods */
     paymentMethods?: string[];
-    /** Base64 encoded image for the payment page */
     imageBase?: string;
-    /** Whether to save the payment token for future use */
     saveToken?: boolean;
 }
 export interface PaymentLink extends PaymentLinkPayload {
@@ -199,3 +164,13 @@ export type AccountDeposits = {
     count: number;
     rows: Deposit[];
 };
+export type RefundResponse = {
+    id: number;
+    orderCode: string;
+    amount: number;
+    currency: string;
+    state: string;
+    type: string;
+    createdAt: string;
+    completedAt: string;
+};

package/interfaces/paymentlink/index.d.ts

@@ -46,7 +46,6 @@ declare enum Reasons {
     SENDING_YOU_A_KISS = 80
 }
 export interface PaymentLinkPayload {
-    accountId: number;
     reference: string;
     concept: string;
     favorite: boolean;
@@ -61,6 +60,9 @@ export interface PaymentLinkPayload {
     urlFailed: string;
     urlNotification: string;
     serviceDate: string;
+    /**
+     * fgfsgdfgdfgd
+     */
     client?: {
         name: string;
         lastName: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yosle/tropipayjs",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Javascript / Typescript SDK for the Tropipay API",
   "main": "index.js",
   "scripts": {
@@ -12,7 +12,10 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/yosle/tropipayjs"
+    "url": "git+https://github.com/yosle/tropipayjs.git"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "keywords": [
     "Javascript",

package/paymentcard/paymentcard.spec.d.ts

@@ -0,0 +1 @@
+declare function sum(a: number, b: number): number;

package/src/api/TropipayAPI.ts

@@ -15,6 +15,7 @@ import {
   MediationPaymentCardConfig,
   LoginResponse,
   AccountDeposits,
+  RefundResponse,
 } from "../interfaces";
 type ServerMode = "Development" | "Production";
 import TropipayHooks from "../hooks/TropipayHooks";
@@ -22,13 +23,11 @@ import PaymentCard from "../paymentcard/PaymentCard";
 import MediationPaymentCard from "../mediationPaymentCard/MediationPaymentCard";
 import DepositAccounts from "../depositAccount/depositAccounts";
 import { TropipayJSException, handleExceptions } from "../utils/errors";
-import Accounts from "../accounts/accounts";
 export class Tropipay {
   readonly clientId: string;
   readonly clientSecret: string;
   readonly scopes: String[];
   public request: Axios;
-  public loginRequest: Axios;
   public static accessToken: string | null;
   public static refreshToken: string | null;
   public static expiresIn: number | null;
@@ -37,7 +36,6 @@ export class Tropipay {
   public paymentCards: PaymentCard;
   public depositAccounts: DepositAccounts;
   public mediationPaymentCard: MediationPaymentCard;
-  public accounts: Accounts;
 
   /**
    * Initializes a new instance of the Tropipay class.
@@ -58,6 +56,7 @@ export class Tropipay {
         "ALLOW_GET_BALANCE",
         "ALLOW_GET_MOVEMENT_LIST",
         "ALLOW_GET_CREDENTIAL",
+        "ALLOW_REFUND",
       ];
     } else {
       this.scopes = config.scopes;
@@ -75,12 +74,11 @@ export class Tropipay {
     this.clientSecret = config.clientSecret;
     this.serverMode = config.serverMode || "Development";
 
-    const tpp_env =
-      this.serverMode === "Production"
-        ? "https://www.tropipay.com"
-        : "https://sandbox.tropipay.me";
+    const tpp_env = this.serverMode === "Production"
+    ? "https://www.tropipay.com"
+    : "https://tropipay-dev.herokuapp.com";
     this.request = axios.create({
-      baseURL: config.customTropipayUrl || tpp_env,
+      baseURL: config.customTropipayUrl || tpp_env,        
       headers: {
         "Content-Type": "application/json",
         Accept: "application/json",
@@ -88,33 +86,27 @@ export class Tropipay {
       },
     });
 
-    // Create a separate instance for login requests
-    this.loginRequest = axios.create({
-      baseURL: config.customTropipayUrl || tpp_env,
-      headers: {
-        "Content-Type": "application/json",
-        Accept: "application/json",
-      },
-    });
 
-    // Add request interceptor for Token expired
-    this.request.interceptors.request.use(
-      async (config) => {
-        const currentTimestamp = Math.floor(Date.now() / 1000);
+     // Add request interceptor for Token expired
+     this.request.interceptors.request.use(
+      async (config: any) => {
+        const currentTimestamp = Math.floor(Date.now() / 1000); // Current time in seconds
 
         if (Tropipay.expiresIn && Tropipay.expiresIn < currentTimestamp) {
-          console.debug("Token expired, attempting to log in");
+          // Token has expired, attempt to refresh it
           try {
-            await this.login();
+             await this.login();
           } catch (error) {
-            throw handleExceptions(error as Error);
+            // Handle token refresh error
+            Tropipay.accessToken = null;
+            Tropipay.refreshToken = null;
+            throw handleExceptions(error as any);
           }
         }
-        // Update the Authorization header in the config
-        config.headers.Authorization = `Bearer ${Tropipay.accessToken}`;
+
         return config;
       },
-      (error) => {
+      (error: AxiosError) => {
         return Promise.reject(error);
       }
     );
@@ -124,14 +116,34 @@ export class Tropipay {
     this.mediationPaymentCard = new MediationPaymentCard(this);
 
     this.depositAccounts = new DepositAccounts(this);
-    this.accounts = new Accounts(this)
+
+    
   }
 
   public async login() {
     try {
+      if (Tropipay.refreshToken) {
+        const { data } = await this.request.post<LoginResponse>(
+          "/api/v2/access/token",
+          {
+            client_id: this.clientId,
+            client_secret: this.clientSecret,
+            grant_type: "refresh_token",
+            refresh_token: Tropipay.refreshToken,
+          },
+          {
+            headers: {
+              "Content-Type": "application/json",
+              Accept: "application/json",
+            },
+          }
+        );
+        return data;
+      }
+
       // normal credetials login
-      const { data } = await this.loginRequest.post<LoginResponse>(
-        "/api/v3/access/token",
+      const { data } = await this.request.post<LoginResponse>(
+        "/api/v2/access/token",
         {
           client_id: this.clientId,
           client_secret: this.clientSecret,
@@ -147,13 +159,13 @@ export class Tropipay {
       );
 
       Tropipay.accessToken = data.access_token;
+      Tropipay.refreshToken = data.refresh_token;
       Tropipay.expiresIn = data.expires_in;
       return data;
     } catch (error) {
       Tropipay.accessToken = null;
       Tropipay.refreshToken = null;
       Tropipay.expiresIn = null;
-      Tropipay.expiresIn = null;
       throw handleExceptions(error as any);
     }
   }
@@ -316,6 +328,7 @@ export class Tropipay {
    * belonging or not to the TropiPay platform with the particularity
    * that the payment will be held in custody or retained until it is
    * released with the approval of the payer.
+   * @deprecated This method is no longer supported and may be removed in a future release.
    * @see https://tpp.stoplight.io/docs/tropipay-api-doc/12a128ff971e4-creating-a-mediation-payment-card
    * @param config Payload with the payment details
    */
@@ -340,6 +353,91 @@ export class Tropipay {
       throw handleExceptions(error as any);
     }
   }
+
+  /**
+   * Refund a completed transaction.
+   * Requires 2FA enabled and ALLOW_REFUND permission on the Tropipay account.
+   *
+   * In Development mode, `securityCode` defaults to `"123456"` when omitted.
+   * In Production mode, you must first call `requestSecurityCode()` to receive
+   * the 2FA code via SMS, then pass it as the `securityCode` parameter.
+   *
+   * @see https://doc.tropipay.com/docs/api-reference/movements#refund-a-transaction
+   * @param orderCode Code of the order/transaction to refund (e.g. "ORD-123456")
+   * @param amount Amount to refund in cents (e.g. 5000 = 50.00 USD/EUR)
+   * @param securityCode 2FA confirmation code. Use "123456" in Development or
+   * the code received via SMS in Production (obtained via requestSecurityCode()).
+   */
+  async refundMovement(
+    orderCode: string,
+    amount: number,
+    securityCode: string
+  ): Promise<RefundResponse> {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+
+    if (!this.scopes.includes("ALLOW_REFUND")) {
+      throw new TropipayJSException(
+        "The credential does not have the ALLOW_REFUND scope required to perform refunds. If you believe your account should have this permission, please contact Tropipay support.",
+        403,
+        null
+      );
+    }
+
+    try {
+      const response = await this.request.post(
+        "/api/v3/movements/in/refund",
+        { orderCode, amount, securityCode },
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${Tropipay.accessToken}`,
+          },
+        }
+      );
+      return response.data as RefundResponse;
+    } catch (error) {
+      throw handleExceptions(error as any);
+    }
+  }
+
+  /**
+   * Request a 2FA security code to be sent via SMS for confirming sensitive
+   * operations like refunds.
+   *
+   * In Production mode, you must call this method first to trigger an SMS with
+   * the code, then use the received code when calling `refundMovement()`.
+   * In Development mode this is not required as the default code "123456"
+   * is used automatically.
+   *
+   * @see https://doc.tropipay.com/docs/api-reference/movements#refund-a-transaction
+   * @returns The API response confirming the code was sent
+   */
+  async requestSecurityCode(type: "sms" | "email" = "sms"): Promise<any> {
+    if (!Tropipay.accessToken) {
+      await this.login();
+    }
+
+    try {
+      const response = await this.request.post(
+        "/api/v3/users/sendSecurityCode",
+        { type },
+        {
+          headers: {
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            Authorization: `Bearer ${Tropipay.accessToken}`,
+          },
+        }
+      );
+      return response.data;
+    } catch (error) {
+      throw handleExceptions(error as any);
+    }
+  }
+
 }
 
 export class ClientSideUtils {
@@ -357,4 +455,5 @@ export const Scopes = {
   ALLOW_GET_BALANCE: "ALLOW_GET_BALANCE",
   ALLOW_GET_MOVEMENT_LIST: "ALLOW_GET_MOVEMENT_LIST",
   ALLOW_GET_CREDENTIAL: "ALLOW_GET_CREDENTIAL",
+  ALLOW_REFUND: "ALLOW_REFUND",
 };

package/src/depositAccount/depositAccounts.ts

@@ -18,7 +18,7 @@ export default class DepositAccounts {
     }
     try {
       const deposit = await this.tropipay.request.get(
-        `/api/v3/deposit_accounts`,
+        `/api/v2/deposit_accounts`,
         {
           headers: {
             "Content-Type": "application/json",
@@ -43,7 +43,7 @@ export default class DepositAccounts {
     }
     try {
       const deposit = await this.tropipay.request.post(
-        "/api/v3/deposit_accounts",
+        "/api/v2/deposit_accounts",
         depositAccountObj,
         {
           headers: {
@@ -70,7 +70,7 @@ export default class DepositAccounts {
     }
     try {
       const deposit = await this.tropipay.request.get(
-        `/api/v3/deposit_accounts/${id}`,
+        `/api/v2/deposit_accounts/${id}`,
         {
           headers: {
             "Content-Type": "application/json",
@@ -96,7 +96,7 @@ export default class DepositAccounts {
     }
     try {
       const deposit = await this.tropipay.request.put(
-        `/api/v3/deposit_accounts/`,
+        `/api/v2/deposit_accounts/`,
         {
           headers: {
             "Content-Type": "application/json",
@@ -122,7 +122,7 @@ export default class DepositAccounts {
     }
     try {
       const deposit = await this.tropipay.request.delete(
-        `/api/v3/deposit_accounts/${id}`,
+        `/api/v2/deposit_accounts/${id}`,
         {
           headers: {
             "Content-Type": "application/json",

package/src/index.ts

@@ -26,3 +26,4 @@ export * from "./depositAccount/depositAccounts";
 export * from "./interfaces/index";
 export { SERVER_MODE } from "./config/TropipayConfig";
 export * from "./constants/TropipayConstants";
+export type { RefundResponse } from "./interfaces/index";