@tapsilat/tapsilat-js 2025.8.19 → 2025.12.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [2025.12.05] - 2025-12-05
11
+
12
+ ### Added
13
+ - **New Features**:
14
+ - `verifyWebhook`: Enhanced webhook signature verification.
15
+ - `healthCheck`: Check API health status.
16
+ - `terminateOrderTerm`: Terminate a specific order term.
17
+ - `orderManualCallback`: Trigger a manual callback for an order.
18
+ - `orderRelatedUpdate`: Update related order reference.
19
+ - `getOrganizationSettings`: Retrieve organization settings.
20
+ - `getOrderTerm`: Retrieve details of a specific order term.
21
+ - **Subscription Management**: Full suite of subscription methods (`createSubscription`, `getSubscription`, `listSubscriptions`, `cancelSubscription`, `redirectSubscription`).
22
+
23
+ ### Changed
24
+ - Updated `package.json` version to `2025.12.05`.
25
+ - Refactored tests to align with project structure.
26
+
10
27
  ## [1.0.4] - 2025-06-16
11
28
 
12
29
  ### Changed
package/README.md CHANGED
@@ -324,6 +324,60 @@ const terminatedOrder = await tapsilat.terminateOrder({
324
324
  console.log('Order terminated at:', terminatedOrder.terminated_at);
325
325
  ```
326
326
 
327
+ ### Subscription Management
328
+
329
+ #### Create Subscription
330
+ ```typescript
331
+ const subscription = await tapsilat.createSubscription({
332
+ plan_id: 'plan-123',
333
+ subscriber: {
334
+ name: 'John',
335
+ surname: 'Doe',
336
+ email: 'john@example.com',
337
+ gsm_number: '+905551234567'
338
+ },
339
+ pricing: {
340
+ amount: 100,
341
+ currency: 'TRY'
342
+ }
343
+ });
344
+ console.log('Subscription created:', subscription.reference_id);
345
+ ```
346
+
347
+ #### Get Subscription Details
348
+ ```typescript
349
+ const sub = await tapsilat.getSubscription({
350
+ reference_id: 'sub-ref-123'
351
+ });
352
+ console.log('Subscription status:', sub.status);
353
+ ```
354
+
355
+ #### List Subscriptions
356
+ ```typescript
357
+ const subs = await tapsilat.listSubscriptions(1, 10);
358
+ subs.rows.forEach(sub => {
359
+ console.log(`Subscription ${sub.reference_id}: ${sub.status}`);
360
+ });
361
+ ```
362
+
363
+ #### Cancel Subscription
364
+ ```typescript
365
+ const result = await tapsilat.cancelSubscription({
366
+ reference_id: 'sub-ref-123',
367
+ reason: 'Customer request'
368
+ });
369
+ console.log('Subscription cancelled:', result.success);
370
+ ```
371
+
372
+ #### Redirect Subscription
373
+ ```typescript
374
+ const redirect = await tapsilat.redirectSubscription({
375
+ reference_id: 'sub-ref-123',
376
+ return_url: 'https://mysite.com/callback'
377
+ });
378
+ console.log('Redirect URL:', redirect.url);
379
+ ```
380
+
327
381
  ### Validation Utilities
328
382
 
329
383
  #### GSM Number Validation
@@ -332,15 +386,15 @@ import { validateGsmNumber } from "@tapsilat/tapsilat-js";
332
386
 
333
387
  const gsmResult = validateGsmNumber('+90 555 123 45 67');
334
388
  if (gsmResult.isValid) {
335
- console.log('Cleaned number:', gsmResult.cleanedNumber); // +905551234567
389
+ console.log('Cleaned number:', gsmResult.cleanedNumber); // +90000000000
336
390
  } else {
337
391
  console.error('Invalid GSM:', gsmResult.error);
338
392
  }
339
393
 
340
394
  // Supports multiple formats
341
- validateGsmNumber('0555 123 45 67'); // National format
342
- validateGsmNumber('555 123 45 67'); // Local format
343
- validateGsmNumber('5551234567'); // No formatting
395
+ validateGsmNumber('0999 123 45 67'); // National format
396
+ validateGsmNumber('999 123 45 67'); // Local format
397
+ validateGsmNumber('9991234567'); // No formatting
344
398
  ```
345
399
 
346
400
  #### Installments Validation
@@ -366,6 +420,34 @@ if (!invalid.isValid) {
366
420
  }
367
421
  ```
368
422
 
423
+ ### Organization & Settings
424
+
425
+ #### Get Organization Settings
426
+ ```typescript
427
+ const settings = await tapsilat.getOrganizationSettings();
428
+ console.log('Organization Settings:', settings);
429
+ ```
430
+
431
+ ### Manual Operations
432
+
433
+ #### Trigger Manual Callback
434
+ ```typescript
435
+ const callbackResult = await tapsilat.orderManualCallback(
436
+ 'order-reference-id',
437
+ 'conversation-id' // optional
438
+ );
439
+ console.log('Callback triggered:', callbackResult.success);
440
+ ```
441
+
442
+ #### Update Related Order
443
+ ```typescript
444
+ const updateResult = await tapsilat.orderRelatedUpdate(
445
+ 'order-reference-id',
446
+ 'related-reference-id'
447
+ );
448
+ console.log('Related order updated:', updateResult.success);
449
+ ```
450
+
369
451
  ### Health Monitoring
370
452
 
371
453
  #### API Health Check
@@ -1,5 +1,5 @@
1
1
  import { ConfigManager } from "./config/ConfigManager";
2
- import { TapsilatConfig, PaginatedResponse, Order, OrderRefundRequest, OrderRefundResponse, OrderStatusResponse, OrderPaymentDetail, OrderCreateRequest, OrderCreateResponse, OrderPaymentTermCreateDTO, OrderPaymentTermUpdateDTO, OrderTermRefundRequest, PaymentTermResponse, PaymentTermDeleteRequest, PaymentTermRefundResponse, PaymentTermTerminateRequest, OrderTerminateRequest, OrderTerminateResponse } from "./types/index";
2
+ import { TapsilatConfig, PaginatedResponse, Order, OrderRefundRequest, OrderRefundResponse, OrderStatusResponse, OrderPaymentDetail, OrderCreateRequest, OrderCreateResponse, OrderPaymentTermCreateDTO, OrderPaymentTermUpdateDTO, OrderTermRefundRequest, PaymentTermResponse, PaymentTermDeleteRequest, PaymentTermRefundResponse, PaymentTermTerminateRequest, OrderTerminateRequest, OrderTerminateResponse, SubscriptionGetRequest, SubscriptionCancelRequest, SubscriptionCreateRequest, SubscriptionRedirectRequest, SubscriptionDetail, SubscriptionCreateResponse, SubscriptionRedirectResponse, OrganizationSettings } from "./types/index";
3
3
  /**
4
4
  * Main SDK class for Tapsilat payment operations
5
5
  *
@@ -34,7 +34,7 @@ export declare class TapsilatSDK {
34
34
  *
35
35
  * @param {TapsilatConfig} config - SDK configuration options
36
36
  * @param {string} config.bearerToken - API authentication token (required)
37
- * @param {string} [config.baseURL='https://api.tapsilat.com/v1'] - API base URL
37
+ * @param {string} [config.baseURL='https://panel.tapsilat.dev/v1'] - API base URL
38
38
  * @param {number} [config.timeout=30000] - Request timeout in milliseconds
39
39
  * @param {number} [config.maxRetries=3] - Maximum number of retry attempts
40
40
  * @param {number} [config.retryDelay=1000] - Delay between retries in milliseconds
@@ -48,57 +48,53 @@ export declare class TapsilatSDK {
48
48
  /**
49
49
  * Creates a new order and returns a checkout URL
50
50
  *
51
- * @summary Initiates a new payment order with buyer information and generates checkout URL
51
+ * @summary Initiates a new payment order with comprehensive order details
52
52
  * @description
53
53
  * Creates a new payment order in the Tapsilat system with the provided order details.
54
54
  * This method performs comprehensive validation of all input parameters, creates the order
55
- * on the payment platform, and returns a checkout URL that customers can use to complete
56
- * their payment. The method supports multiple currencies, locales, and comprehensive
57
- * buyer information for compliance and fraud prevention.
55
+ * on the payment platform, and returns order identifiers including reference_id and order_id.
56
+ * The method supports multiple currencies, locales, payment options, basket items,
57
+ * and comprehensive buyer information for compliance and fraud prevention.
58
58
  *
59
- * The returned checkout URL is valid for a limited time (typically 24 hours) and should
60
- * be presented to the customer immediately. The order status can be tracked using the
61
- * returned reference ID through the getOrderStatus method.
59
+ * The returned order_id and reference_id can be used to track order status through
60
+ * the getOrderStatus method.
62
61
  *
63
62
  * @param {OrderCreateRequest} orderRequest - Complete order information
64
63
  * @param {number} orderRequest.amount - Payment amount (must be positive, max 2 decimal places)
64
+ * @param {number} [orderRequest.tax_amount] - Tax amount included in total
65
65
  * @param {Currency} orderRequest.currency - Payment currency ('TRY', 'USD', 'EUR', 'GBP')
66
66
  * @param {Locale} orderRequest.locale - Display language ('tr' for Turkish, 'en' for English)
67
+ * @param {boolean} [orderRequest.three_d_force] - Force 3D Secure authentication
68
+ * @param {Address} [orderRequest.shipping_address] - Shipping address for delivery
69
+ * @param {BasketItem[]} orderRequest.basket_items - Array of items in the order
70
+ * @param {BillingAddress} orderRequest.billing_address - Billing address with tax information
67
71
  * @param {Buyer} orderRequest.buyer - Customer information for payment processing
68
- * @param {string} orderRequest.buyer.name - Customer's first name (required)
69
- * @param {string} orderRequest.buyer.surname - Customer's last name (required)
70
- * @param {string} orderRequest.buyer.email - Customer's email address (required, validated)
71
- * @param {string} [orderRequest.buyer.phone] - Customer's phone number
72
- * @param {string} [orderRequest.buyer.identityNumber] - National ID or tax number
73
- * @param {Address} [orderRequest.buyer.shippingAddress] - Shipping address for physical goods
74
- * @param {Address} [orderRequest.buyer.billingAddress] - Billing address for invoicing
75
- * @param {string} [orderRequest.description] - Order description for customer reference
76
- * @param {string} [orderRequest.callbackUrl] - URL to redirect after payment completion
77
- * @param {string} [orderRequest.conversationId] - Custom tracking ID for your system
72
+ * @param {string} [orderRequest.conversation_id] - Custom tracking ID for your system
73
+ * @param {boolean} [orderRequest.partial_payment] - Enable partial payment
74
+ * @param {boolean} [orderRequest.payment_methods] - Enable payment method selection
75
+ * @param {PaymentOption[]} [orderRequest.payment_options] - Available payment options
76
+ * @param {string} [orderRequest.payment_success_url] - URL to redirect after successful payment
77
+ * @param {string} [orderRequest.payment_failure_url] - URL to redirect after failed payment
78
+ * @param {number[]} [orderRequest.enabled_installments] - Allowed installment counts
78
79
  * @param {Record<string, unknown>} [orderRequest.metadata] - Additional custom data
79
80
  *
80
81
  * @returns {Promise<OrderCreateResponse>} Promise resolving to order creation response
81
- * @returns {string} OrderCreateResponse.referenceId - Unique order identifier for tracking
82
- * @returns {string} OrderCreateResponse.conversationId - Echo of provided conversation ID
83
- * @returns {string} OrderCreateResponse.checkoutUrl - Payment page URL for customer
84
- * @returns {string} OrderCreateResponse.status - Initial order status (typically 'CREATED')
85
- * @returns {string} [OrderCreateResponse.qrCodeUrl] - QR code URL for mobile payments
82
+ * @returns {string} OrderCreateResponse.order_id - Internal order identifier
83
+ * @returns {string} OrderCreateResponse.reference_id - Unique order reference for tracking
84
+ * @returns {string} [OrderCreateResponse.checkout_url] - Payment page URL for customer
85
+ * @returns {string} [OrderCreateResponse.conversation_id] - Echo of provided conversation ID
86
+ * @returns {string} [OrderCreateResponse.status] - Initial order status
87
+ * @returns {string} [OrderCreateResponse.qr_code_url] - QR code URL for mobile payments
86
88
  *
87
89
  * @throws {TapsilatValidationError} When input validation fails:
88
90
  * - Amount is not positive or has more than 2 decimal places
89
91
  * - Currency is not supported
90
92
  * - Buyer information is incomplete or invalid
91
- * - Email format is invalid
93
+ * - Basket items are missing or invalid
94
+ * - Billing address is missing
92
95
  * - Required fields are missing
93
- * @throws {TapsilatNetworkError} When network request fails:
94
- * - Connection timeout
95
- * - DNS resolution failure
96
- * - Network connectivity issues
97
- * @throws {TapsilatError} When API returns business logic errors:
98
- * - Insufficient merchant balance
99
- * - Currency not enabled for merchant
100
- * - Buyer blocked due to fraud detection
101
- * - Rate limiting exceeded
96
+ * @throws {TapsilatNetworkError} When network request fails
97
+ * @throws {TapsilatError} When API returns business logic errors
102
98
  */
103
99
  createOrder(orderRequest: OrderCreateRequest): Promise<OrderCreateResponse>;
104
100
  /**
@@ -436,5 +432,17 @@ export declare class TapsilatSDK {
436
432
  * @throws {TapsilatError} When API returns an error response
437
433
  */
438
434
  terminateOrder(terminateData: OrderTerminateRequest): Promise<OrderTerminateResponse>;
435
+ orderManualCallback(referenceId: string, conversationId?: string): Promise<any>;
436
+ orderRelatedUpdate(referenceId: string, relatedReferenceId: string): Promise<any>;
437
+ getOrganizationSettings(): Promise<OrganizationSettings>;
438
+ getOrderTerm(termReferenceId: string): Promise<any>;
439
+ createSubscription(request: SubscriptionCreateRequest): Promise<SubscriptionCreateResponse>;
440
+ getSubscription(request: SubscriptionGetRequest): Promise<SubscriptionDetail>;
441
+ listSubscriptions(params?: {
442
+ page?: number;
443
+ per_page?: number;
444
+ }): Promise<PaginatedResponse<any>>;
445
+ cancelSubscription(request: SubscriptionCancelRequest): Promise<any>;
446
+ redirectSubscription(request: SubscriptionRedirectRequest): Promise<SubscriptionRedirectResponse>;
439
447
  }
440
448
  //# sourceMappingURL=TapsilatSDK.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"TapsilatSDK.d.ts","sourceRoot":"","sources":["../src/TapsilatSDK.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"TapsilatSDK.d.ts","sourceRoot":"","sources":["../src/TapsilatSDK.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/http/HttpClient.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAQ7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD;;;;;GAKG;AACH,MAAM,WAAW,aAAc,SAAQ,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;AAErE;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnB,MAAM,GACN,OAAO,EAAE,GACT,MAAM,GACN,QAAQ,CAAC;AAEb;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4B;IAEzD;;;;;OAKG;gBACS,MAAM,EAAE,cAAc;IAIlC;;;OAGG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAQ1B;;;OAGG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpB,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAS1B;;;OAGG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACtD,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAS1B;;;OAGG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACpB,KAAK,CAAC,CAAC,GAAG,OAAO,EACrB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,EACjB,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAS1B;;;OAGG;IACG,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IACzD,MAAM,CAAC,CAAC,GAAG,OAAO,EACtB,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAQ1B;;;;;;;;;;OAUG;YACW,OAAO;IAgErB;;;;;;;;;OASG;YACW,WAAW;IA0CzB;;;;;;;OAOG;YACW,eAAe;IAuC7B;;;;;;;;OAQG;IACH,OAAO,CAAC,uBAAuB;IA6D/B;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAa3B;;;;;;;OAOG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAgB5B;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ;IAoChB;;;;;;;;;OASG;YACW,mBAAmB;IAuCjC;;;;;;;OAOG;IACH,OAAO,CAAC,cAAc;IAStB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;;;;OAOG;IACH,OAAO,CAAC,KAAK;IAMb;;;;;;OAMG;IACH,eAAe,IAAI,kBAAkB;IAIrC;;;;;;;OAOG;IACH,qBAAqB,CACnB,WAAW,EAAE,UAAU,CAAC,kBAAkB,CAAC,uBAAuB,CAAC,CAAC,CAAC,CAAC,CAAC,GACtE,MAAM;IAIT;;;;;;;OAOG;IACH,sBAAsB,CACpB,WAAW,EAAE,UAAU,CAAC,kBAAkB,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC,GACvE,MAAM;IAIT;;;;;;;OAOG;IACH,mBAAmB,CACjB,WAAW,EAAE,UAAU,CAAC,kBAAkB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAC,GACpE,MAAM;CAGV"}
1
+ {"version":3,"file":"HttpClient.d.ts","sourceRoot":"","sources":["../../src/http/HttpClient.ts"],"names":[],"mappings":"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"}
package/dist/index.d.ts CHANGED
@@ -94,12 +94,51 @@ interface Customer {
94
94
  * @interface Address
95
95
  */
96
96
  interface Address {
97
- street: string;
97
+ address: string;
98
98
  city: string;
99
- state?: string;
100
- postalCode: string;
99
+ contact_name: string;
101
100
  country: string;
101
+ zip_code: string;
102
+ district?: string;
103
+ contact_phone?: string;
102
104
  }
105
+ /**
106
+ * @category Customer Data
107
+ * @summary Billing address with tax information
108
+ * @description Extended address structure for billing with tax and company details
109
+ * @interface BillingAddress
110
+ */
111
+ interface BillingAddress extends Address {
112
+ billing_type: "PERSONAL" | "CORPORATE";
113
+ vat_number?: string;
114
+ tax_office?: string;
115
+ title?: string;
116
+ }
117
+ /**
118
+ * @category Order Management
119
+ * @summary Item in the order basket
120
+ * @description Represents a product or service in the order with pricing and categorization
121
+ * @interface BasketItem
122
+ */
123
+ interface BasketItem {
124
+ id: string;
125
+ name: string;
126
+ category1: string;
127
+ category2?: string;
128
+ item_type: string;
129
+ price: number;
130
+ quantity: number;
131
+ coupon_discount?: number;
132
+ data?: string;
133
+ quantity_unit?: string;
134
+ }
135
+ /**
136
+ * @category Payment Processing
137
+ * @summary Available payment options for customers
138
+ * @description Different payment methods that can be enabled for an order
139
+ * @typedef {string} PaymentOption
140
+ */
141
+ type PaymentOption = "PAY_WITH_WALLET" | "PAY_WITH_CARD" | "PAY_WITH_LOAN" | "PAY_WITH_CASH" | "PAY_WITH_BANK";
103
142
  /**
104
143
  * @category Refunds
105
144
  * @summary Information needed to process a refund
@@ -206,13 +245,19 @@ type Locale = "tr" | "en";
206
245
  * @interface Buyer
207
246
  */
208
247
  interface Buyer {
248
+ id?: string;
209
249
  name: string;
210
250
  surname: string;
211
251
  email: string;
212
- phone?: string;
213
- identityNumber?: string;
214
- shippingAddress?: Address;
215
- billingAddress?: Address;
252
+ gsm_number?: string;
253
+ identity_number?: string;
254
+ registration_address?: string;
255
+ city?: string;
256
+ country?: string;
257
+ zip_code?: string;
258
+ ip?: string;
259
+ registration_date?: string;
260
+ last_login_date?: string;
216
261
  }
217
262
  /**
218
263
  * @category Order Management
@@ -222,12 +267,21 @@ interface Buyer {
222
267
  */
223
268
  interface OrderCreateRequest {
224
269
  amount: number;
225
- currency: Currency;
270
+ tax_amount?: number;
226
271
  locale: Locale;
272
+ three_d_force?: boolean;
273
+ currency: Currency;
274
+ shipping_address?: Address;
275
+ basket_items: BasketItem[];
276
+ billing_address: BillingAddress;
227
277
  buyer: Buyer;
228
- description?: string;
229
- callbackUrl?: string;
230
- conversationId?: string;
278
+ conversation_id?: string;
279
+ partial_payment?: boolean;
280
+ payment_methods?: boolean;
281
+ payment_options?: PaymentOption[];
282
+ payment_success_url?: string;
283
+ payment_failure_url?: string;
284
+ enabled_installments?: number[];
231
285
  metadata?: Record<string, unknown>;
232
286
  }
233
287
  /**
@@ -237,11 +291,12 @@ interface OrderCreateRequest {
237
291
  * @interface OrderCreateResponse
238
292
  */
239
293
  interface OrderCreateResponse {
240
- referenceId: string;
241
- conversationId: string;
242
- checkoutUrl: string;
243
- status: string;
244
- qrCodeUrl?: string;
294
+ order_id: string;
295
+ reference_id: string;
296
+ checkout_url?: string;
297
+ conversation_id?: string;
298
+ status?: string;
299
+ qr_code_url?: string;
245
300
  }
246
301
  /**
247
302
  * @category Order Management
@@ -723,6 +778,90 @@ interface InstallmentsValidationResult {
723
778
  error?: string;
724
779
  originalInput: string | number | number[];
725
780
  }
781
+ interface SubscriptionGetRequest {
782
+ external_reference_id?: string;
783
+ reference_id?: string;
784
+ }
785
+ interface SubscriptionCancelRequest {
786
+ external_reference_id?: string;
787
+ reference_id?: string;
788
+ }
789
+ interface SubscriptionBilling {
790
+ address?: string;
791
+ city?: string;
792
+ contact_name?: string;
793
+ country?: string;
794
+ vat_number?: string;
795
+ zip_code?: string;
796
+ }
797
+ interface SubscriptionUser {
798
+ address?: string;
799
+ city?: string;
800
+ country?: string;
801
+ email?: string;
802
+ first_name?: string;
803
+ id?: string;
804
+ identity_number?: string;
805
+ last_name?: string;
806
+ phone?: string;
807
+ zip_code?: string;
808
+ }
809
+ interface SubscriptionCreateRequest {
810
+ amount?: number;
811
+ billing?: SubscriptionBilling;
812
+ card_id?: string;
813
+ currency?: string;
814
+ cycle?: number;
815
+ external_reference_id?: string;
816
+ failure_url?: string;
817
+ payment_date?: number;
818
+ period?: number;
819
+ success_url?: string;
820
+ title?: string;
821
+ user?: SubscriptionUser;
822
+ }
823
+ interface SubscriptionRedirectRequest {
824
+ subscription_id?: string;
825
+ }
826
+ interface SubscriptionOrder {
827
+ amount?: string;
828
+ currency?: string;
829
+ payment_date?: string;
830
+ payment_url?: string;
831
+ reference_id?: string;
832
+ status?: string;
833
+ }
834
+ interface SubscriptionDetail {
835
+ amount?: string;
836
+ currency?: string;
837
+ due_date?: string;
838
+ external_reference_id?: string;
839
+ is_active?: boolean;
840
+ orders?: SubscriptionOrder[];
841
+ payment_date?: number;
842
+ payment_status?: string;
843
+ period?: number;
844
+ title?: string;
845
+ }
846
+ interface SubscriptionCreateResponse {
847
+ code?: number;
848
+ message?: string;
849
+ order_reference_id?: string;
850
+ reference_id?: string;
851
+ }
852
+ interface SubscriptionRedirectResponse {
853
+ url?: string;
854
+ }
855
+ interface OrganizationSettings {
856
+ ttl?: number;
857
+ retry_count?: number;
858
+ allow_payment?: boolean;
859
+ session_ttl?: number;
860
+ custom_checkout?: boolean;
861
+ domain_address?: string;
862
+ checkout_domain?: string;
863
+ subscription_domain?: string;
864
+ }
726
865
 
727
866
  /**
728
867
  * @category Configuration
@@ -835,7 +974,7 @@ declare class TapsilatSDK {
835
974
  *
836
975
  * @param {TapsilatConfig} config - SDK configuration options
837
976
  * @param {string} config.bearerToken - API authentication token (required)
838
- * @param {string} [config.baseURL='https://api.tapsilat.com/v1'] - API base URL
977
+ * @param {string} [config.baseURL='https://panel.tapsilat.dev/v1'] - API base URL
839
978
  * @param {number} [config.timeout=30000] - Request timeout in milliseconds
840
979
  * @param {number} [config.maxRetries=3] - Maximum number of retry attempts
841
980
  * @param {number} [config.retryDelay=1000] - Delay between retries in milliseconds
@@ -849,57 +988,53 @@ declare class TapsilatSDK {
849
988
  /**
850
989
  * Creates a new order and returns a checkout URL
851
990
  *
852
- * @summary Initiates a new payment order with buyer information and generates checkout URL
991
+ * @summary Initiates a new payment order with comprehensive order details
853
992
  * @description
854
993
  * Creates a new payment order in the Tapsilat system with the provided order details.
855
994
  * This method performs comprehensive validation of all input parameters, creates the order
856
- * on the payment platform, and returns a checkout URL that customers can use to complete
857
- * their payment. The method supports multiple currencies, locales, and comprehensive
858
- * buyer information for compliance and fraud prevention.
995
+ * on the payment platform, and returns order identifiers including reference_id and order_id.
996
+ * The method supports multiple currencies, locales, payment options, basket items,
997
+ * and comprehensive buyer information for compliance and fraud prevention.
859
998
  *
860
- * The returned checkout URL is valid for a limited time (typically 24 hours) and should
861
- * be presented to the customer immediately. The order status can be tracked using the
862
- * returned reference ID through the getOrderStatus method.
999
+ * The returned order_id and reference_id can be used to track order status through
1000
+ * the getOrderStatus method.
863
1001
  *
864
1002
  * @param {OrderCreateRequest} orderRequest - Complete order information
865
1003
  * @param {number} orderRequest.amount - Payment amount (must be positive, max 2 decimal places)
1004
+ * @param {number} [orderRequest.tax_amount] - Tax amount included in total
866
1005
  * @param {Currency} orderRequest.currency - Payment currency ('TRY', 'USD', 'EUR', 'GBP')
867
1006
  * @param {Locale} orderRequest.locale - Display language ('tr' for Turkish, 'en' for English)
1007
+ * @param {boolean} [orderRequest.three_d_force] - Force 3D Secure authentication
1008
+ * @param {Address} [orderRequest.shipping_address] - Shipping address for delivery
1009
+ * @param {BasketItem[]} orderRequest.basket_items - Array of items in the order
1010
+ * @param {BillingAddress} orderRequest.billing_address - Billing address with tax information
868
1011
  * @param {Buyer} orderRequest.buyer - Customer information for payment processing
869
- * @param {string} orderRequest.buyer.name - Customer's first name (required)
870
- * @param {string} orderRequest.buyer.surname - Customer's last name (required)
871
- * @param {string} orderRequest.buyer.email - Customer's email address (required, validated)
872
- * @param {string} [orderRequest.buyer.phone] - Customer's phone number
873
- * @param {string} [orderRequest.buyer.identityNumber] - National ID or tax number
874
- * @param {Address} [orderRequest.buyer.shippingAddress] - Shipping address for physical goods
875
- * @param {Address} [orderRequest.buyer.billingAddress] - Billing address for invoicing
876
- * @param {string} [orderRequest.description] - Order description for customer reference
877
- * @param {string} [orderRequest.callbackUrl] - URL to redirect after payment completion
878
- * @param {string} [orderRequest.conversationId] - Custom tracking ID for your system
1012
+ * @param {string} [orderRequest.conversation_id] - Custom tracking ID for your system
1013
+ * @param {boolean} [orderRequest.partial_payment] - Enable partial payment
1014
+ * @param {boolean} [orderRequest.payment_methods] - Enable payment method selection
1015
+ * @param {PaymentOption[]} [orderRequest.payment_options] - Available payment options
1016
+ * @param {string} [orderRequest.payment_success_url] - URL to redirect after successful payment
1017
+ * @param {string} [orderRequest.payment_failure_url] - URL to redirect after failed payment
1018
+ * @param {number[]} [orderRequest.enabled_installments] - Allowed installment counts
879
1019
  * @param {Record<string, unknown>} [orderRequest.metadata] - Additional custom data
880
1020
  *
881
1021
  * @returns {Promise<OrderCreateResponse>} Promise resolving to order creation response
882
- * @returns {string} OrderCreateResponse.referenceId - Unique order identifier for tracking
883
- * @returns {string} OrderCreateResponse.conversationId - Echo of provided conversation ID
884
- * @returns {string} OrderCreateResponse.checkoutUrl - Payment page URL for customer
885
- * @returns {string} OrderCreateResponse.status - Initial order status (typically 'CREATED')
886
- * @returns {string} [OrderCreateResponse.qrCodeUrl] - QR code URL for mobile payments
1022
+ * @returns {string} OrderCreateResponse.order_id - Internal order identifier
1023
+ * @returns {string} OrderCreateResponse.reference_id - Unique order reference for tracking
1024
+ * @returns {string} [OrderCreateResponse.checkout_url] - Payment page URL for customer
1025
+ * @returns {string} [OrderCreateResponse.conversation_id] - Echo of provided conversation ID
1026
+ * @returns {string} [OrderCreateResponse.status] - Initial order status
1027
+ * @returns {string} [OrderCreateResponse.qr_code_url] - QR code URL for mobile payments
887
1028
  *
888
1029
  * @throws {TapsilatValidationError} When input validation fails:
889
1030
  * - Amount is not positive or has more than 2 decimal places
890
1031
  * - Currency is not supported
891
1032
  * - Buyer information is incomplete or invalid
892
- * - Email format is invalid
1033
+ * - Basket items are missing or invalid
1034
+ * - Billing address is missing
893
1035
  * - Required fields are missing
894
- * @throws {TapsilatNetworkError} When network request fails:
895
- * - Connection timeout
896
- * - DNS resolution failure
897
- * - Network connectivity issues
898
- * @throws {TapsilatError} When API returns business logic errors:
899
- * - Insufficient merchant balance
900
- * - Currency not enabled for merchant
901
- * - Buyer blocked due to fraud detection
902
- * - Rate limiting exceeded
1036
+ * @throws {TapsilatNetworkError} When network request fails
1037
+ * @throws {TapsilatError} When API returns business logic errors
903
1038
  */
904
1039
  createOrder(orderRequest: OrderCreateRequest): Promise<OrderCreateResponse>;
905
1040
  /**
@@ -1237,6 +1372,18 @@ declare class TapsilatSDK {
1237
1372
  * @throws {TapsilatError} When API returns an error response
1238
1373
  */
1239
1374
  terminateOrder(terminateData: OrderTerminateRequest): Promise<OrderTerminateResponse>;
1375
+ orderManualCallback(referenceId: string, conversationId?: string): Promise<any>;
1376
+ orderRelatedUpdate(referenceId: string, relatedReferenceId: string): Promise<any>;
1377
+ getOrganizationSettings(): Promise<OrganizationSettings>;
1378
+ getOrderTerm(termReferenceId: string): Promise<any>;
1379
+ createSubscription(request: SubscriptionCreateRequest): Promise<SubscriptionCreateResponse>;
1380
+ getSubscription(request: SubscriptionGetRequest): Promise<SubscriptionDetail>;
1381
+ listSubscriptions(params?: {
1382
+ page?: number;
1383
+ per_page?: number;
1384
+ }): Promise<PaginatedResponse<any>>;
1385
+ cancelSubscription(request: SubscriptionCancelRequest): Promise<any>;
1386
+ redirectSubscription(request: SubscriptionRedirectRequest): Promise<SubscriptionRedirectResponse>;
1240
1387
  }
1241
1388
 
1242
1389
  /**
@@ -1444,4 +1591,4 @@ declare function validateGsmNumber(gsmNumber: string | number): GsmValidationRes
1444
1591
  declare function validateInstallments(installments: string | number | number[]): InstallmentsValidationResult;
1445
1592
 
1446
1593
  export { ConfigManager, TapsilatAuthenticationError, TapsilatError, TapsilatNetworkError, TapsilatRateLimitError, TapsilatSDK, TapsilatValidationError, isValidCurrency, isValidPaymentMethod, isValidUrl, sanitizeMetadata, validateEmail, validateGsmNumber, validateInstallments, validatePaymentRequest };
1447
- 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 };
1594
+ export type { APIError, APIResponse, Address, BasketItem, BasketItemDTO, BasketItemPayerDTO, BillingAddress, 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, PaymentOption, PaymentRequest, PaymentResponse, PaymentStatus, PaymentTermDTO, PaymentTermDeleteRequest, PaymentTermRefundResponse, PaymentTermResponse, PaymentTermTerminateRequest, RefundOrderDTO, RefundRequest, RefundResponse, ShippingAddressDTO, SubOrganizationDTO, SubmerchantDTO, TapsilatConfig, WebhookEvent };
@@ -1 +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,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"}
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,cAAc,EACd,UAAU,EACV,aAAa,EACb,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"}