Merge branch 'master' into added-limit-inquiry

beratallahverdi · web-flow · commit bec3c850680a · 2026-04-01T15:16:18.000+03:00
diff --git a/samples/payment/InitCheckoutCardVerify.js b/samples/payment/InitCheckoutCardVerify.js
@@ -0,0 +1,19 @@
+const Craftgate = require('../../dist');
+
+const craftgate = new Craftgate.Client({
+  apiKey: 'api-key',
+  secretKey: 'secret-key',
+  baseUrl: 'https://sandbox-api.craftgate.io'
+});
+
+const request = {
+  verificationPrice: 10,
+  currency: Craftgate.Model.Currency.TRY,
+  conversationId: '456d1297-908e-4bd6-a13b-4be31a6e47d5',
+  callbackUrl: 'https://www.your-website.com/craftgate-checkout-card-verify-callback',
+  paymentAuthenticationType: Craftgate.Model.CardVerificationAuthType.NonThreeDs
+};
+
+craftgate.payment().initCheckoutCardVerify(request)
+  .then(result => console.info('Init checkout card verify successful', result))
+  .catch(err => console.error('Init checkout card verify failed', err));
diff --git a/samples/payment/InitMultiPayment.js b/samples/payment/InitMultiPayment.js
@@ -0,0 +1,39 @@
+const Craftgate = require('../../dist');
+
+const craftgate = new Craftgate.Client({
+    apiKey: 'api-key',
+    secretKey: 'secret-key',
+    baseUrl: 'https://sandbox-api.craftgate.io'
+});
+
+const request = {
+    price: 100.0,
+    paidPrice: 100.0,
+    callbackUrl: 'https://www.your-website.com/craftgate-checkout-callback',
+    currency: Craftgate.Model.Currency.TRY,
+    conversationId: '456d1297-908e-4bd6-a13b-4be31a6e47d5',
+    externalId: '123d1297-839e-4bd6-a13b-4be31a6e12b8',
+    paymentGroup: Craftgate.Model.PaymentGroup.ListingOrSubscription,
+    paymentPhase: Craftgate.Model.PaymentPhase.Auth,
+    items: [
+        {
+            name: 'Item 1',
+            price: 30.0,
+            externalId: '123d1297-839e-4bd6-a13b-4be31a6e12a8'
+        },
+        {
+            name: 'Item 2',
+            price: 50.0,
+            externalId: '789d1297-839e-4bd6-a13b-4be31a6e13f7'
+        },
+        {
+            name: 'Item 3',
+            price: 20.0,
+            externalId: '3a1d1297-839e-4bd6-a13b-4be31a6e18e6'
+        }
+    ]
+};
+
+craftgate.payment().initMultiPayment(request)
+  .then(payment => console.info('Init Multi payment', payment))
+  .catch(err => console.error('Failed to init multi payment', err));
diff --git a/samples/payment/StoreCardWithSecureFields.js b/samples/payment/StoreCardWithSecureFields.js
@@ -0,0 +1,15 @@
+const Craftgate = require('../../dist');
+
+const craftgate = new Craftgate.Client({
+  apiKey: 'api-key',
+  secretKey: 'secret-key',
+  baseUrl: 'https://sandbox-api.craftgate.io'
+});
+
+const request = {
+  secureFieldsToken:"xxXXxx",
+};
+
+craftgate.payment().storeCard(request)
+  .then(results => console.info('Store card response', results))
+  .catch(err => console.error('Failed to store card', err));
diff --git a/samples/payment/VerifyCard.js b/samples/payment/VerifyCard.js
@@ -0,0 +1,28 @@
+const Craftgate = require('../../dist');
+
+const craftgate = new Craftgate.Client({
+  apiKey: 'api-key',
+  secretKey: 'secret-key',
+  baseUrl: 'https://sandbox-api.craftgate.io'
+});
+
+const request = {
+  card: {
+    cardHolderName: 'Haluk Demir',
+    cardNumber: '5258640000000001',
+    expireYear: '2044',
+    expireMonth: '07',
+    cvc: '000',
+    cardAlias: 'My YKB Card'
+  },
+  paymentAuthenticationType: Craftgate.Model.CardVerificationAuthType.ThreeDs,
+  callbackUrl: 'https://www.your-website.com/craftgate-3DSecure-card-verify-callback',
+  conversationId: '456d1297-908e-4bd6-a13b-4be31a6e47d5',
+  verificationPrice: 10,
+  currency: Craftgate.Model.Currency.TRY,
+  clientIp: '127.0.0.1'
+};
+
+craftgate.payment().verifyCard(request)
+  .then(result => console.info('Verify card successful', result))
+  .catch(err => console.error('Verify card failed', err));
diff --git a/src/CraftgateError.ts b/src/CraftgateError.ts
@@ -1,18 +1,26 @@
+type ProviderError = {
+  errorCode?: string;
+  errorMessage?: string;
+};
+
 type ErrorResponse = {
   errorCode: string;
   errorDescription: string;
+  providerError?: ProviderError;
 };
 
 export default class CraftgateError extends Error {
   private _errorCode: string;
   private _errorDescription: string;
+  private _providerError?: ProviderError;
   private _errorData: any;
 
-  constructor({errorCode, errorDescription, ...rest}: ErrorResponse) {
+  constructor({errorCode, errorDescription, providerError, ...rest}: ErrorResponse) {
     super(errorDescription);
 
     this._errorCode = errorCode;
     this._errorDescription = errorDescription;
+    this._providerError = providerError;
     this._errorData = rest;
 
     Object.setPrototypeOf(this, CraftgateError.prototype);
@@ -26,6 +34,10 @@ export default class CraftgateError extends Error {
     return this._errorDescription;
   }
 
+  getProviderError(): ProviderError | undefined {
+    return this._providerError;
+  }
+
   getErrorData(): any {
     return this._errorData;
   }
diff --git a/src/adapter/MerchantApmAdapter.ts b/src/adapter/MerchantApmAdapter.ts
@@ -1,11 +1,7 @@
 import {ClientCreationOptions} from '../lib/HttpClient';
 
-import RetrieveDailyPaymentReportRequest from '../request/RetrieveDailyPaymentReportRequest';
-import RetrieveDailyTransactionReportRequest from '../request/RetrieveDailyTransactionReportRequest';
-
 import DataResponse from '../response/DataResponse';
 import MerchantApmResponse from '../response/MerchantApmResponse';
-import WalletResponse from '../response/WalletResponse';
 
 import BaseAdapter from './BaseAdapter';
 
diff --git a/src/adapter/PaymentAdapter.ts b/src/adapter/PaymentAdapter.ts
@@ -19,8 +19,10 @@ import InitApmDepositPaymentRequest from '../request/InitApmDepositPaymentReques
 import InitApmPaymentRequest from '../request/InitApmPaymentRequest';
 import InitBnplLimitInquiryRequest from '../request/InitBnplLimitInquiryRequest';
 import InitBnplPaymentRequest from '../request/InitBnplPaymentRequest';
+import InitCheckoutCardVerifyRequest from '../request/InitCheckoutCardVerifyRequest';
 import InitCheckoutPaymentRequest from '../request/InitCheckoutPaymentRequest';
 import InitGarantiPayPaymentRequest from '../request/InitGarantiPayPaymentRequest';
+import InitMultiPaymentRequest from '../request/InitMultiPaymentRequest';
 import InitPosApmPaymentRequest from '../request/InitPosApmPaymentRequest';
 import InitThreeDSPaymentRequest from '../request/InitThreeDSPaymentRequest';
 import PostAuthPaymentRequest from '../request/PostAuthPaymentRequest';
@@ -34,6 +36,7 @@ import SearchStoredCardsRequest from '../request/SearchStoredCardsRequest';
 import StoreCardRequest from '../request/StoreCardRequest';
 import UpdateCardRequest from '../request/UpdateCardRequest';
 import UpdatePaymentTransactionRequest from '../request/UpdatePaymentTransactionRequest';
+import VerifyCardRequest from '../request/VerifyCardRequest';
 
 import ApmDepositPaymentResponse from '../response/ApmDepositPaymentResponse';
 import BnplLimitInquiryResponse from '../response/BnplLimitInquiryResponse';
@@ -45,8 +48,10 @@ import DepositPaymentResponse from '../response/DepositPaymentResponse';
 import FundTransferDepositPaymentResponse from '../response/FundTransferDepositPaymentResponse';
 import InitApmPaymentResponse from '../response/InitApmPaymentResponse';
 import InitBnplPaymentResponse from '../response/InitBnplPaymentResponse';
+import InitCheckoutCardVerifyResponse from '../response/InitCheckoutCardVerifyResponse';
 import InitCheckoutPaymentResponse from '../response/InitCheckoutPaymentResponse';
 import InitGarantiPayPaymentResponse from '../response/InitGarantiPayPaymentResponse';
+import InitMultiPaymentResponse from '../response/InitMultipaymentPaymentResponse';
 import InitPosApmPaymentResponse from '../response/InitPosApmPaymentResponse';
 import InitThreeDSPaymentResponse from '../response/InitThreeDSPaymentResponse';
 import InstantTransferBanksResponse from '../response/InstantTransferBanksResponse';
@@ -57,8 +62,10 @@ import PaymentTransactionApprovalListResponse from '../response/PaymentTransacti
 import PaymentTransactionRefundListResponse from '../response/PaymentTransactionRefundListResponse';
 import PaymentTransactionRefundResponse from '../response/PaymentTransactionRefundResponse';
 import PaymentTransactionResponse from '../response/PaymentTransactionResponse';
+import RetrieveCheckoutCardVerifyResponse from '../response/RetrieveCheckoutCardVerifyResponse';
 import RetrieveLoyaltiesResponse from '../response/RetrieveLoyaltiesResponse';
 import StoredCardResponse from '../response/StoredCardResponse';
+import VerifyCardResponse from '../response/VerifyCardResponse';
 import WaitingPaymentRefundResponse from '../response/WaitingPaymentRefundResponse';
 
 import BaseAdapter from './BaseAdapter';
@@ -92,6 +99,14 @@ export default class PaymentAdapter extends BaseAdapter {
     return this._client.post('/payment/v1/checkout-payments/init', request);
   }
 
+  async initCheckoutCardVerify(request: InitCheckoutCardVerifyRequest): Promise<InitCheckoutCardVerifyResponse> {
+    return this._client.post('/payment/v1/checkout-card-verify/init', request);
+  }
+
+  async retrieveCheckoutCardVerify(token: string): Promise<RetrieveCheckoutCardVerifyResponse> {
+    return this._client.get(`/payment/v1/checkout-card-verify/${token}`);
+  }
+
   async retrieveCheckoutPayment(token: string): Promise<PaymentResponse> {
     return this._client.get(`/payment/v1/checkout-payments/${token}`);
   }
@@ -192,6 +207,10 @@ export default class PaymentAdapter extends BaseAdapter {
     await this._client.post('/payment/v1/cards/delete', request);
   }
 
+  async verifyCard(request: VerifyCardRequest): Promise<VerifyCardResponse> {
+    return this._client.post('/payment/v1/cards/verify', request);
+  }
+
   async approvePaymentTransactions(request: ApprovePaymentTransactionsRequest): Promise<PaymentTransactionApprovalListResponse> {
     return this._client.post('/payment/v1/payment-transactions/approve', request);
   }
@@ -240,6 +259,10 @@ export default class PaymentAdapter extends BaseAdapter {
     return this._client.get(`/payment/v1/instant-transfer-banks`);
   }
 
+  async initMultiPayment(request: InitMultiPaymentRequest): Promise<InitMultiPaymentResponse> {
+    return this._client.post(`/payment/v1/multi-payments/init`, request);
+  }
+
   async retrieveMultiPayment(token: string): Promise<MultiPaymentResponse> {
     return this._client.get(`/payment/v1/multi-payments/${token}`);
   }
diff --git a/src/model/CardVerificationAuthType.ts b/src/model/CardVerificationAuthType.ts
@@ -0,0 +1,7 @@
+enum CardVerificationAuthType {
+  NonThreeDs = 'NON_THREE_DS',
+  ThreeDs = 'THREE_DS',
+  None = 'NONE'
+}
+
+export default CardVerificationAuthType;
diff --git a/src/model/CardVerifyStatus.ts b/src/model/CardVerifyStatus.ts
@@ -0,0 +1,7 @@
+enum CardVerifyStatus {
+  Success = 'SUCCESS',
+  Failure = 'FAILURE',
+  ThreeDsPending = 'THREE_DS_PENDING'
+}
+
+export default CardVerifyStatus;
diff --git a/src/model/WebhookEventType.ts b/src/model/WebhookEventType.ts
@@ -11,6 +11,7 @@ enum WebhookEventType {
   WalletTxCreated = 'WALLET_TX_CREATED',
   BnplNotification = 'BNPL_NOTIFICATION',
   MultiPaymentCompleted = 'MULTI_PAYMENT_COMPLETED',
+  MultiPaymentExpired = 'MULTI_PAYMENT_EXPIRED',
   BkmExpressPaymentNotification = 'BKM_EXPRESS_PAYMENT_NOTIFICATION'
 }
 
diff --git a/src/model/index.ts b/src/model/index.ts
@@ -8,6 +8,8 @@ import CardAssociation from './CardAssociation';
 import CardBrand from './CardBrand';
 import CardExpiryStatus from './CardExpiryStatus';
 import CardType from './CardType';
+import CardVerificationAuthType from './CardVerificationAuthType';
+import CardVerifyStatus from './CardVerifyStatus';
 import ClientType from './ClientType';
 import Currency from './Currency';
 import FileStatus from './FileStatus';
@@ -111,5 +113,7 @@ export = {
   PosUserType,
   PosOperationType,
   CardBrand,
+  CardVerificationAuthType,
+  CardVerifyStatus,
   ClientType
 };
diff --git a/src/request/InitCheckoutCardVerifyRequest.ts b/src/request/InitCheckoutCardVerifyRequest.ts
@@ -0,0 +1,14 @@
+import CardVerificationAuthType from '../model/CardVerificationAuthType';
+import Currency from '../model/Currency';
+
+type InitCheckoutCardVerifyRequest = {
+  verificationPrice: number;
+  currency: Currency;
+  conversationId?: string;
+  callbackUrl: string;
+  cardUserKey?: string;
+  paymentAuthenticationType: CardVerificationAuthType;
+  ttl?: number;
+};
+
+export default InitCheckoutCardVerifyRequest;
diff --git a/src/request/InitCheckoutPaymentRequest.ts b/src/request/InitCheckoutPaymentRequest.ts
@@ -32,6 +32,7 @@ type InitCheckoutPaymentRequest = {
   allowInstallmentOnlyCommercialCards?: boolean;
   forceThreeDS?: boolean;
   forceAuthForNonCreditCards?: boolean;
+  returnBackUrl?: string;
   ttl?: number;
   customInstallments?: CustomInstallment[];
   items?: PaymentItem[];
diff --git a/src/request/InitMultiPaymentRequest.ts b/src/request/InitMultiPaymentRequest.ts
@@ -0,0 +1,39 @@
+import Currency from '../model/Currency';
+import PaymentGroup from '../model/PaymentGroup';
+import PaymentMethod from '../model/PaymentMethod';
+import PaymentPhase from '../model/PaymentPhase';
+import PaymentSource from '../model/PaymentSource';
+
+import PaymentItem from './dto/PaymentItem';
+
+type InitMultiPaymentRequest = {
+  price: number;
+  paidPrice: number;
+  currency: Currency;
+  paymentGroup: PaymentGroup;
+  paymentSource?: PaymentSource;
+  conversationId?: string;
+  externalId?: string;
+  callbackUrl: string;
+  paymentPhase?: PaymentPhase;
+  paymentChannel?: string;
+  enabledPaymentMethods?: PaymentMethod[];
+  cardUserKey?: string;
+  buyerMemberId?: number;
+  allowOnlyCreditCard?: boolean;
+  forceAuthForNonCreditCards?: boolean;
+  allowOnlyStoredCards?: boolean;
+  allowInstallmentOnlyCommercialCards?: boolean;
+  alwaysStoreCardAfterPayment?: boolean;
+  disableStoreCard?: boolean;
+  forceThreeDS?: boolean;
+  masterpassGsmNumber?: string;
+  masterpassUserId?: string;
+  apmUserIdentity?: string;
+  items?: PaymentItem[];
+  ttl?: number;
+  maximumSplitPaymentCount?: number;
+  additionalParams?: Record<string, unknown>;
+};
+
+export default InitMultiPaymentRequest;
diff --git a/src/request/StoreCardRequest.ts b/src/request/StoreCardRequest.ts
@@ -1,10 +1,14 @@
+import {EncryptedCard} from './dto/EncryptedCard';
+
 type StoreCardRequest = {
   cardHolderName: string;
   cardNumber: string;
   expireYear: string;
   expireMonth: string;
+  secureFieldsToken?: string;
   cardAlias?: string;
   cardUserKey?: string;
+  encryptedCard?: EncryptedCard;
 };
 
 export default StoreCardRequest;
diff --git a/src/request/UpdatePaymentTransactionRequest.ts b/src/request/UpdatePaymentTransactionRequest.ts
@@ -1,6 +1,7 @@
 type UpdatePaymentTransactionRequest = {
   subMerchantMemberPrice: number;
   subMerchantMemberId: number;
+  blockageResolvedDate?: Date;
 };
 
 export default UpdatePaymentTransactionRequest;
diff --git a/src/request/VerifyCardRequest.ts b/src/request/VerifyCardRequest.ts
@@ -0,0 +1,16 @@
+import CardVerificationAuthType from '../model/CardVerificationAuthType';
+import Currency from '../model/Currency';
+
+import VerifyCard from './dto/VerifyCard';
+
+type VerifyCardRequest = {
+  card: VerifyCard;
+  paymentAuthenticationType: CardVerificationAuthType;
+  verificationPrice: number;
+  currency: Currency;
+  clientIp?: string;
+  conversationId?: string;
+  callbackUrl?: string;
+};
+
+export default VerifyCardRequest;
diff --git a/src/request/dto/Card.ts b/src/request/dto/Card.ts
@@ -1,6 +1,8 @@
 import {Loyalty} from '../../model/Loyalty';
 import TokenizedCardType from '../../model/TokenizedCardType';
 
+import {EncryptedCard} from './EncryptedCard';
+
 export type PaymentCard = {
   cardAlias?: string;
   cardHolderName: string;
@@ -36,4 +38,8 @@ export type SecureFieldsCard = {
   secureFieldsToken: string;
 };
 
-export type Card = PaymentCard | StoredCard | First6Last4CardWithIdentityNumber | TokenizedCard | SecureFieldsCard;
+export type EncryptedCardType = {
+  encryptedCard: EncryptedCard;
+};
+
+export type Card = PaymentCard | StoredCard | First6Last4CardWithIdentityNumber | TokenizedCard | SecureFieldsCard | EncryptedCardType;
diff --git a/src/request/dto/EncryptedCard.ts b/src/request/dto/EncryptedCard.ts
diff --git a/src/request/dto/VerifyCard.ts b/src/request/dto/VerifyCard.ts
diff --git a/src/response/InitCheckoutCardVerifyResponse.ts b/src/response/InitCheckoutCardVerifyResponse.ts
diff --git a/src/response/InitMultipaymentPaymentResponse.ts b/src/response/InitMultipaymentPaymentResponse.ts
diff --git a/src/response/RetrieveCheckoutCardVerifyResponse.ts b/src/response/RetrieveCheckoutCardVerifyResponse.ts
diff --git a/src/response/StoredCardResponse.ts b/src/response/StoredCardResponse.ts
diff --git a/src/response/VerifyCardResponse.ts b/src/response/VerifyCardResponse.ts
diff --git a/test/adapter/PaymentAdapter.test.js b/test/adapter/PaymentAdapter.test.js

Original file line number	Diff line number	Diff line change
`@@ -11,6 +11,7 @@ enum WebhookEventType {`
`11`	`11`	`WalletTxCreated = 'WALLET_TX_CREATED',`
`12`	`12`	`BnplNotification = 'BNPL_NOTIFICATION',`
`13`	`13`	`MultiPaymentCompleted = 'MULTI_PAYMENT_COMPLETED',`
	`14`	`+ MultiPaymentExpired = 'MULTI_PAYMENT_EXPIRED',`
`14`	`15`	`BkmExpressPaymentNotification = 'BKM_EXPRESS_PAYMENT_NOTIFICATION'`
`15`	`16`	`}`
`16`	`17`