@tapsilat/tapsilat-js 1.0.6 → 2025.8.19

package/README.md

@@ -6,11 +6,6 @@
 
 **Enterprise-grade TypeScript SDK for Tapsilat Payment Processing Platform**
 
-[![Version](https://---
-
-## Advanced C## Authenticationnfiguration.shields.io/badge/version-1.0.4-blue.svg)](https://www.npmjs.com/package/@tapsilat/tapsilat-js)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
 </div>
 
 ## About Tapsilat
@@ -73,6 +68,53 @@ console.log("Order status:", status.status);
 
 ---
 
+## Features
+
+### Core Payment Operations
+- Secure authentication with bearer tokens
+- Complete payment lifecycle management
+- Multi-currency support (TRY, USD, EUR, GBP)
+- Advanced filtering and pagination
+
+### Payment Term Management
+- Create and manage installment plans
+- Update payment terms (amount, dates, status)
+- Delete payment terms
+- Term-specific refunds and termination
+- Complete order termination
+
+### Validation & Utilities
+- Turkish GSM number validation and formatting
+- Installment validation with flexible input formats
+- Input validation for all request parameters
+- Webhook signature verification
+
+### Technical Features
+- Full TypeScript support
+- Modern ES6+ architecture
+- Automatic retry logic
+- Configuration management
+- Health monitoring
+- Request/response interceptors
+
+---
+
+## SDK Compatibility
+
+This JavaScript SDK provides full feature parity with Tapsilat's Python and .NET SDKs:
+
+| Feature Category | JavaScript | Python | .NET | 
+|-----------------|------------|--------|------|
+| Order Management | Yes | Yes | Yes |
+| Payment Terms | Yes | Yes | Yes |
+| GSM Validation | Yes | Yes | Yes |
+| Installment Validation | Yes | Yes | Yes |
+| Webhook Verification | Yes | No | No |
+| TypeScript Support | Yes | No | Yes |
+| Health Monitoring | Yes | No | No |
+
+---
+
 ## API Methods & Examples
 
 ### Order Management
@@ -218,6 +260,112 @@ app.post('/webhooks/tapsilat', async (req, res) => {
 });
 ```
 
+### Payment Term Management
+
+#### Create Payment Term
+```typescript
+const paymentTerm = await tapsilat.createOrderTerm({
+  order_id: 'order-reference-id',
+  term_reference_id: 'term-001',
+  amount: 250.00,
+  due_date: '2024-12-31',
+  term_sequence: 1,
+  required: true,
+  status: 'pending',
+  data: 'First installment'
+});
+console.log('Payment term created:', paymentTerm.term_reference_id);
+```
+
+#### Update Payment Term
+```typescript
+const updatedTerm = await tapsilat.updateOrderTerm({
+  term_reference_id: 'term-001',
+  amount: 275.00,
+  due_date: '2025-01-15',
+  status: 'updated'
+});
+console.log('Payment term updated:', updatedTerm.status);
+```
+
+#### Delete Payment Term
+```typescript
+const deletedTerm = await tapsilat.deleteOrderTerm({
+  term_reference_id: 'term-001'
+});
+console.log('Payment term deleted:', deletedTerm.term_reference_id);
+```
+
+#### Refund Payment Term
+```typescript
+const termRefund = await tapsilat.refundOrderTerm({
+  term_id: 'term-001',
+  amount: 100.00,
+  reference_id: 'refund-ref-123'
+});
+console.log('Term refund processed:', termRefund.refund_id);
+```
+
+#### Terminate Payment Term
+```typescript
+const terminatedTerm = await tapsilat.terminateOrderTerm({
+  term_reference_id: 'term-001',
+  reason: 'Customer request'
+});
+console.log('Payment term terminated:', terminatedTerm.status);
+```
+
+#### Terminate Order
+```typescript
+const terminatedOrder = await tapsilat.terminateOrder({
+  reference_id: 'order-reference-id',
+  reason: 'Business decision'
+});
+console.log('Order terminated at:', terminatedOrder.terminated_at);
+```
+
+### Validation Utilities
+
+#### GSM Number Validation
+```typescript
+import { validateGsmNumber } from "@tapsilat/tapsilat-js";
+
+const gsmResult = validateGsmNumber('+90 555 123 45 67');
+if (gsmResult.isValid) {
+  console.log('Cleaned number:', gsmResult.cleanedNumber); // +905551234567
+} else {
+  console.error('Invalid GSM:', gsmResult.error);
+}
+
+// Supports multiple formats
+validateGsmNumber('0555 123 45 67');  // National format
+validateGsmNumber('555 123 45 67');   // Local format
+validateGsmNumber('5551234567');      // No formatting
+```
+
+#### Installments Validation
+```typescript
+import { validateInstallments } from "@tapsilat/tapsilat-js";
+
+// Single installment
+const single = validateInstallments(3);
+console.log(single.validatedInstallments); // [3]
+
+// Multiple installments
+const multiple = validateInstallments('1,3,6,12');
+console.log(multiple.validatedInstallments); // [1, 3, 6, 12]
+
+// Array format
+const array = validateInstallments([6, 3, 12, 1]);
+console.log(array.validatedInstallments); // [1, 3, 6, 12] (sorted, unique)
+
+// Error handling
+const invalid = validateInstallments('abc');
+if (!invalid.isValid) {
+  console.error('Validation error:', invalid.error);
+}
+```
+
 ### Health Monitoring
 
 #### API Health Check

package/dist/TapsilatSDK.d.ts

@@ -1,5 +1,5 @@
 import { ConfigManager } from "./config/ConfigManager";
-import { TapsilatConfig, PaginatedResponse, Order, OrderRefundRequest, OrderRefundResponse, OrderStatusResponse, OrderPaymentDetail, OrderCreateRequest, OrderCreateResponse } from "./types/index";
+import { TapsilatConfig, PaginatedResponse, Order, OrderRefundRequest, OrderRefundResponse, OrderStatusResponse, OrderPaymentDetail, OrderCreateRequest, OrderCreateResponse, OrderPaymentTermCreateDTO, OrderPaymentTermUpdateDTO, OrderTermRefundRequest, PaymentTermResponse, PaymentTermDeleteRequest, PaymentTermRefundResponse, PaymentTermTerminateRequest, OrderTerminateRequest, OrderTerminateResponse } from "./types/index";
 /**
  * Main SDK class for Tapsilat payment operations
  *
@@ -318,5 +318,123 @@ export declare class TapsilatSDK {
      * @returns ConfigManager instance for configuration operations
      */
     getConfigManager(): ConfigManager;
+    /**
+     * Creates a new payment term for an existing order
+     *
+     * @summary Create payment term for installment or partial payment
+     * @description
+     * Creates a new payment term for an existing order, enabling installment payments
+     * or partial payment collection. Payment terms allow splitting order amounts
+     * across multiple payments with specific due dates and requirements.
+     *
+     * @param {OrderPaymentTermCreateDTO} termData - Payment term creation data
+     * @param {string} termData.order_id - Reference ID of the existing order
+     * @param {string} termData.term_reference_id - Unique identifier for this payment term
+     * @param {number} termData.amount - Amount for this payment term
+     * @param {string} termData.due_date - Due date for this payment (ISO 8601 format)
+     * @param {number} termData.term_sequence - Sequence number for this term
+     * @param {boolean} termData.required - Whether this payment term is required
+     * @param {string} termData.status - Initial status of the payment term
+     * @param {string} [termData.data] - Additional metadata for the term
+     * @param {string} [termData.paid_date] - Date when payment was completed
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to created payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    createOrderTerm(termData: OrderPaymentTermCreateDTO): Promise<PaymentTermResponse>;
+    /**
+     * Updates an existing payment term
+     *
+     * @summary Update payment term details
+     * @description
+     * Updates an existing payment term with new information such as amount,
+     * due date, status, or other metadata. This allows for flexible management
+     * of installment payments and payment schedules.
+     *
+     * @param {OrderPaymentTermUpdateDTO} updateData - Payment term update data
+     * @param {string} updateData.term_reference_id - Reference ID of the term to update
+     * @param {number} [updateData.amount] - New amount for the payment term
+     * @param {string} [updateData.due_date] - New due date (ISO 8601 format)
+     * @param {string} [updateData.paid_date] - Date when payment was completed
+     * @param {boolean} [updateData.required] - Whether this payment term is required
+     * @param {string} [updateData.status] - New status of the payment term
+     * @param {number} [updateData.term_sequence] - New sequence number
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to updated payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    updateOrderTerm(updateData: OrderPaymentTermUpdateDTO): Promise<PaymentTermResponse>;
+    /**
+     * Deletes a payment term
+     *
+     * @summary Delete payment term
+     * @description
+     * Permanently deletes a payment term from an order. This action cannot be undone.
+     * Only unpaid payment terms can be deleted.
+     *
+     * @param {PaymentTermDeleteRequest} deleteData - Payment term deletion data
+     * @param {string} deleteData.term_reference_id - Reference ID of the term to delete
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to deleted payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    deleteOrderTerm(deleteData: PaymentTermDeleteRequest): Promise<PaymentTermResponse>;
+    /**
+     * Refunds a specific payment term
+     *
+     * @summary Refund payment term
+     * @description
+     * Processes a refund for a specific payment term. This allows partial refunds
+     * at the payment term level rather than the entire order level.
+     *
+     * @param {OrderTermRefundRequest} refundData - Payment term refund data
+     * @param {string} refundData.term_id - ID of the term to refund
+     * @param {number} refundData.amount - Amount to refund
+     * @param {string} [refundData.reference_id] - Optional reference ID
+     * @param {string} [refundData.term_payment_id] - Optional term payment ID
+     *
+     * @returns {Promise<PaymentTermRefundResponse>} Promise resolving to refund details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    refundOrderTerm(refundData: OrderTermRefundRequest): Promise<PaymentTermRefundResponse>;
+    /**
+     * Terminates a payment term
+     *
+     * @summary Terminate payment term
+     * @description
+     * Terminates an active payment term, preventing further payments.
+     * This is useful for canceling installment plans or payment schedules.
+     *
+     * @param {PaymentTermTerminateRequest} terminateData - Payment term termination data
+     * @param {string} terminateData.term_reference_id - Reference ID of the term to terminate
+     * @param {string} [terminateData.reason] - Optional reason for termination
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to terminated term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    terminateOrderTerm(terminateData: PaymentTermTerminateRequest): Promise<PaymentTermResponse>;
+    /**
+     * Terminates an entire order
+     *
+     * @summary Terminate order
+     * @description
+     * Terminates an entire order, canceling all associated payment terms and
+     * preventing any further payment processing. This is a more comprehensive
+     * action than canceling individual payment terms.
+     *
+     * @param {OrderTerminateRequest} terminateData - Order termination data
+     * @param {string} terminateData.reference_id - Reference ID of the order to terminate
+     * @param {string} [terminateData.reason] - Optional reason for termination
+     *
+     * @returns {Promise<OrderTerminateResponse>} Promise resolving to terminated order details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    terminateOrder(terminateData: OrderTerminateRequest): Promise<OrderTerminateResponse>;
 }
 //# sourceMappingURL=TapsilatSDK.d.ts.map

package/dist/TapsilatSDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TapsilatSDK.d.ts","sourceRoot":"","sources":["../src/TapsilatSDK.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AASvD,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAKvB;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAK9C;;;;;;;;;;;;;;;;;;;;;;;OAuBG;gBACS,MAAM,EAAE,cAAc;IASlC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsDG;IACG,WAAW,CACf,YAAY,EAAE,kBAAkB,GAC/B,OAAO,CAAC,mBAAmB,CAAC;IAwF/B;;;;;;;;;;;OAWG;IACG,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IA0BnD;;;;;;;;;;OAUG;IACG,SAAS,CACb,MAAM,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAwDpC;;;;;;;;;;OAUG;IACG,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAuCtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAmCG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA2BvE;;;;;;;;;;OAUG;IACG,WAAW,CACf,UAAU,EAAE,kBAAkB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IA0B/B;;;;;;;;;;OAUG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA0BvE;;;;;;;;;;;;OAYG;IACG,sBAAsB,CAC1B,WAAW,EAAE,MAAM,EACnB,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAqChC;;;;;;;;;;;OAWG;IACG,wBAAwB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAgCtE;;;;;;;;;;;OAWG;IACG,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA+B/D;;;;;;;;;;OAUG;IACG,oBAAoB,CACxB,MAAM,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAChD,OAAO,CAAC,GAAG,CAAC;IA2Bf;;;;;;;;;;OAUG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAc1D;;;;;;;;;;;OAWG;IACG,aAAa,CACjB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC;IAoBnB;;;;;;;;OAQG;IACG,WAAW,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAwBnE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,gBAAgB,IAAI,aAAa;CAGlC"}
+{"version":3,"file":"TapsilatSDK.d.ts","sourceRoot":"","sources":["../src/TapsilatSDK.ts"],"names":[],"mappings":"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"}

package/dist/__mocks__/HttpClient.d.ts

@@ -0,0 +1,9 @@
+export declare class HttpClient {
+    post: jest.Mock<any, any, any>;
+    get: jest.Mock<any, any, any>;
+    put: jest.Mock<any, any, any>;
+    delete: jest.Mock<any, any, any>;
+    patch: jest.Mock<any, any, any>;
+    constructor();
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/dist/__mocks__/HttpClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/__mocks__/HttpClient.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAU;IACd,IAAI,2BAAa;IACjB,GAAG,2BAAa;IAChB,GAAG,2BAAa;IAChB,MAAM,2BAAa;IACnB,KAAK,2BAAa;;CAS1B"}

package/dist/index.d.ts

@@ -625,6 +625,104 @@ interface OrderResponse {
     checkout_url: string;
     order_id?: string;
 }
+/**
+ * @category Payment Terms
+ * @summary Response data from payment term operations
+ * @description Standard response structure for payment term API operations
+ * @interface PaymentTermResponse
+ */
+interface PaymentTermResponse {
+    term_reference_id: string;
+    order_id: string;
+    amount: number;
+    due_date: string;
+    status: string;
+    term_sequence: number;
+    required: boolean;
+    created_at: string;
+    updated_at?: string;
+    paid_date?: string;
+    data?: string;
+}
+/**
+ * @category Payment Terms
+ * @summary Request data for deleting a payment term
+ * @description Contains the identifier needed to delete a specific payment term
+ * @interface PaymentTermDeleteRequest
+ */
+interface PaymentTermDeleteRequest {
+    term_reference_id: string;
+}
+/**
+ * @category Payment Terms
+ * @summary Response from payment term refund operation
+ * @description Contains details about a processed payment term refund
+ * @interface PaymentTermRefundResponse
+ */
+interface PaymentTermRefundResponse {
+    refund_id: string;
+    term_reference_id: string;
+    amount: number;
+    status: string;
+    created_at: string;
+    refund_reference_id?: string;
+}
+/**
+ * @category Payment Terms
+ * @summary Request to terminate a payment term
+ * @description Data required to terminate an active payment term
+ * @interface PaymentTermTerminateRequest
+ */
+interface PaymentTermTerminateRequest {
+    term_reference_id: string;
+    reason?: string;
+}
+/**
+ * @category Order Management
+ * @summary Request to terminate an order
+ * @description Data required to terminate an active order
+ * @interface OrderTerminateRequest
+ */
+interface OrderTerminateRequest {
+    reference_id: string;
+    reason?: string;
+}
+/**
+ * @category Order Management
+ * @summary Response from order termination
+ * @description Contains details about a terminated order
+ * @interface OrderTerminateResponse
+ */
+interface OrderTerminateResponse {
+    reference_id: string;
+    status: string;
+    terminated_at: string;
+    reason?: string;
+}
+/**
+ * @category Validation
+ * @summary GSM number validation result
+ * @description Contains the validation result and cleaned phone number
+ * @interface GsmValidationResult
+ */
+interface GsmValidationResult {
+    isValid: boolean;
+    cleanedNumber?: string;
+    error?: string;
+    originalNumber: string;
+}
+/**
+ * @category Validation
+ * @summary Installments validation result
+ * @description Contains the validation result for installment values
+ * @interface InstallmentsValidationResult
+ */
+interface InstallmentsValidationResult {
+    isValid: boolean;
+    validatedInstallments: number[];
+    error?: string;
+    originalInput: string | number | number[];
+}
 
 /**
  * @category Configuration
@@ -1021,6 +1119,124 @@ declare class TapsilatSDK {
      * @returns ConfigManager instance for configuration operations
      */
     getConfigManager(): ConfigManager;
+    /**
+     * Creates a new payment term for an existing order
+     *
+     * @summary Create payment term for installment or partial payment
+     * @description
+     * Creates a new payment term for an existing order, enabling installment payments
+     * or partial payment collection. Payment terms allow splitting order amounts
+     * across multiple payments with specific due dates and requirements.
+     *
+     * @param {OrderPaymentTermCreateDTO} termData - Payment term creation data
+     * @param {string} termData.order_id - Reference ID of the existing order
+     * @param {string} termData.term_reference_id - Unique identifier for this payment term
+     * @param {number} termData.amount - Amount for this payment term
+     * @param {string} termData.due_date - Due date for this payment (ISO 8601 format)
+     * @param {number} termData.term_sequence - Sequence number for this term
+     * @param {boolean} termData.required - Whether this payment term is required
+     * @param {string} termData.status - Initial status of the payment term
+     * @param {string} [termData.data] - Additional metadata for the term
+     * @param {string} [termData.paid_date] - Date when payment was completed
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to created payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    createOrderTerm(termData: OrderPaymentTermCreateDTO): Promise<PaymentTermResponse>;
+    /**
+     * Updates an existing payment term
+     *
+     * @summary Update payment term details
+     * @description
+     * Updates an existing payment term with new information such as amount,
+     * due date, status, or other metadata. This allows for flexible management
+     * of installment payments and payment schedules.
+     *
+     * @param {OrderPaymentTermUpdateDTO} updateData - Payment term update data
+     * @param {string} updateData.term_reference_id - Reference ID of the term to update
+     * @param {number} [updateData.amount] - New amount for the payment term
+     * @param {string} [updateData.due_date] - New due date (ISO 8601 format)
+     * @param {string} [updateData.paid_date] - Date when payment was completed
+     * @param {boolean} [updateData.required] - Whether this payment term is required
+     * @param {string} [updateData.status] - New status of the payment term
+     * @param {number} [updateData.term_sequence] - New sequence number
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to updated payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    updateOrderTerm(updateData: OrderPaymentTermUpdateDTO): Promise<PaymentTermResponse>;
+    /**
+     * Deletes a payment term
+     *
+     * @summary Delete payment term
+     * @description
+     * Permanently deletes a payment term from an order. This action cannot be undone.
+     * Only unpaid payment terms can be deleted.
+     *
+     * @param {PaymentTermDeleteRequest} deleteData - Payment term deletion data
+     * @param {string} deleteData.term_reference_id - Reference ID of the term to delete
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to deleted payment term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    deleteOrderTerm(deleteData: PaymentTermDeleteRequest): Promise<PaymentTermResponse>;
+    /**
+     * Refunds a specific payment term
+     *
+     * @summary Refund payment term
+     * @description
+     * Processes a refund for a specific payment term. This allows partial refunds
+     * at the payment term level rather than the entire order level.
+     *
+     * @param {OrderTermRefundRequest} refundData - Payment term refund data
+     * @param {string} refundData.term_id - ID of the term to refund
+     * @param {number} refundData.amount - Amount to refund
+     * @param {string} [refundData.reference_id] - Optional reference ID
+     * @param {string} [refundData.term_payment_id] - Optional term payment ID
+     *
+     * @returns {Promise<PaymentTermRefundResponse>} Promise resolving to refund details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    refundOrderTerm(refundData: OrderTermRefundRequest): Promise<PaymentTermRefundResponse>;
+    /**
+     * Terminates a payment term
+     *
+     * @summary Terminate payment term
+     * @description
+     * Terminates an active payment term, preventing further payments.
+     * This is useful for canceling installment plans or payment schedules.
+     *
+     * @param {PaymentTermTerminateRequest} terminateData - Payment term termination data
+     * @param {string} terminateData.term_reference_id - Reference ID of the term to terminate
+     * @param {string} [terminateData.reason] - Optional reason for termination
+     *
+     * @returns {Promise<PaymentTermResponse>} Promise resolving to terminated term details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    terminateOrderTerm(terminateData: PaymentTermTerminateRequest): Promise<PaymentTermResponse>;
+    /**
+     * Terminates an entire order
+     *
+     * @summary Terminate order
+     * @description
+     * Terminates an entire order, canceling all associated payment terms and
+     * preventing any further payment processing. This is a more comprehensive
+     * action than canceling individual payment terms.
+     *
+     * @param {OrderTerminateRequest} terminateData - Order termination data
+     * @param {string} terminateData.reference_id - Reference ID of the order to terminate
+     * @param {string} [terminateData.reason] - Optional reason for termination
+     *
+     * @returns {Promise<OrderTerminateResponse>} Promise resolving to terminated order details
+     * @throws {TapsilatValidationError} When input validation fails
+     * @throws {TapsilatError} When API returns an error response
+     */
+    terminateOrder(terminateData: OrderTerminateRequest): Promise<OrderTerminateResponse>;
 }
 
 /**
@@ -1188,6 +1404,44 @@ declare function isValidUrl(url: string): boolean;
  * @returns Sanitized metadata object
  */
 declare function sanitizeMetadata(metadata: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Validates and cleans GSM phone numbers
+ *
+ * @summary Validates and cleans Turkish GSM phone numbers
+ * @description
+ * Supports multiple phone number formats including international (+90), national (0),
+ * and local formats. Automatically removes formatting characters and validates
+ * against Turkish mobile number patterns.
+ *
+ * Supported formats:
+ * - +90 5XX XXX XX XX
+ * - 0 5XX XXX XX XX
+ * - 5XX XXX XX XX
+ * - Various formatting with spaces, dashes, parentheses
+ *
+ * @param {string | number} gsmNumber - GSM number to validate and clean
+ * @returns {GsmValidationResult} Validation result with cleaned number or error
+ */
+declare function validateGsmNumber(gsmNumber: string | number): GsmValidationResult;
+/**
+ * Validates installment values and converts to standardized format
+ *
+ * @summary Validates installment values and converts to standardized format
+ * @description
+ * Handles various input formats (string, number, array) and validates against
+ * business rules. Converts single installment values to arrays and validates
+ * that installment numbers are within acceptable ranges.
+ *
+ * Supported inputs:
+ * - Single number: 3 -> [3]
+ * - Comma-separated string: "1,3,6" -> [1,3,6]
+ * - Array of numbers: [1,3,6,12] -> [1,3,6,12]
+ * - Empty/null values default to [1]
+ *
+ * @param {string | number | number[]} installments - Installment values to validate
+ * @returns {InstallmentsValidationResult} Validation result with standardized array
+ */
+declare function validateInstallments(installments: string | number | number[]): InstallmentsValidationResult;
 
-export { ConfigManager, TapsilatAuthenticationError, TapsilatError, TapsilatNetworkError, TapsilatRateLimitError, TapsilatSDK, TapsilatValidationError, isValidCurrency, isValidPaymentMethod, isValidUrl, sanitizeMetadata, validateEmail, validatePaymentRequest };
-export type { APIError, APIResponse, Address, BasketItemDTO, BasketItemPayerDTO, BillingAddressDTO, Buyer, BuyerDTO, CheckoutDesignDTO, Currency, Customer, Locale, MetadataDTO, Order, OrderCardDTO, OrderCreateDTO, OrderCreateRequest, OrderCreateResponse, OrderPFSubMerchantDTO, OrderPaymentDetail, OrderPaymentTermCreateDTO, OrderPaymentTermUpdateDTO, OrderRefundRequest, OrderRefundResponse, OrderResponse, OrderStatusResponse, OrderTermRefundRequest, PaginatedResponse, PaginationParams, PaymentMethod, PaymentRequest, PaymentResponse, PaymentStatus, PaymentTermDTO, RefundOrderDTO, RefundRequest, RefundResponse, ShippingAddressDTO, SubOrganizationDTO, SubmerchantDTO, TapsilatConfig, WebhookEvent };
+export { ConfigManager, TapsilatAuthenticationError, TapsilatError, TapsilatNetworkError, TapsilatRateLimitError, TapsilatSDK, TapsilatValidationError, isValidCurrency, isValidPaymentMethod, isValidUrl, sanitizeMetadata, validateEmail, validateGsmNumber, validateInstallments, validatePaymentRequest };
+export type { APIError, APIResponse, Address, BasketItemDTO, BasketItemPayerDTO, BillingAddressDTO, Buyer, BuyerDTO, CheckoutDesignDTO, Currency, Customer, GsmValidationResult, InstallmentsValidationResult, Locale, MetadataDTO, Order, OrderCardDTO, OrderCreateDTO, OrderCreateRequest, OrderCreateResponse, OrderPFSubMerchantDTO, OrderPaymentDetail, OrderPaymentTermCreateDTO, OrderPaymentTermUpdateDTO, OrderRefundRequest, OrderRefundResponse, OrderResponse, OrderStatusResponse, OrderTermRefundRequest, OrderTerminateRequest, OrderTerminateResponse, PaginatedResponse, PaginationParams, PaymentMethod, PaymentRequest, PaymentResponse, PaymentStatus, PaymentTermDTO, PaymentTermDeleteRequest, PaymentTermRefundResponse, PaymentTermResponse, PaymentTermTerminateRequest, RefundOrderDTO, RefundRequest, RefundResponse, ShippingAddressDTO, SubOrganizationDTO, SubmerchantDTO, TapsilatConfig, WebhookEvent };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,QAAQ,EACR,OAAO,EACP,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EAGjB,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGvD,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,QAAQ,EACR,cAAc,EACd,eAAe,EACf,QAAQ,EACR,OAAO,EACP,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,MAAM,EACN,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,kBAAkB,EAClB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,qBAAqB,EACrB,kBAAkB,EAClB,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,cAAc,EACd,yBAAyB,EACzB,yBAAyB,EACzB,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,4BAA4B,EAC7B,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC"}