@muhammedaksam/sipay-node 1.0.5 → 1.1.0

package/dist/types/status-codes.js

@@ -0,0 +1,300 @@
+"use strict";
+/**
+ * Sipay API Status Codes
+ * Based on official API documentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SipayStatusCategory = exports.SipayStatusDescriptions = exports.SipayStatusCode = exports.SipayHttpStatusCode = void 0;
+exports.getStatusCategory = getStatusCategory;
+exports.isSuccessStatus = isSuccessStatus;
+exports.isErrorStatus = isErrorStatus;
+exports.getStatusDescription = getStatusDescription;
+exports.isRetryableStatus = isRetryableStatus;
+// Server HTTP Status Codes
+var SipayHttpStatusCode;
+(function (SipayHttpStatusCode) {
+    SipayHttpStatusCode[SipayHttpStatusCode["OK"] = 200] = "OK";
+    SipayHttpStatusCode[SipayHttpStatusCode["CREATED"] = 201] = "CREATED";
+    SipayHttpStatusCode[SipayHttpStatusCode["ACCEPTED"] = 202] = "ACCEPTED";
+    SipayHttpStatusCode[SipayHttpStatusCode["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    SipayHttpStatusCode[SipayHttpStatusCode["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    SipayHttpStatusCode[SipayHttpStatusCode["FORBIDDEN"] = 403] = "FORBIDDEN";
+    SipayHttpStatusCode[SipayHttpStatusCode["NOT_FOUND"] = 404] = "NOT_FOUND";
+    SipayHttpStatusCode[SipayHttpStatusCode["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+    SipayHttpStatusCode[SipayHttpStatusCode["CONFLICT"] = 409] = "CONFLICT";
+    SipayHttpStatusCode[SipayHttpStatusCode["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
+    SipayHttpStatusCode[SipayHttpStatusCode["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
+    SipayHttpStatusCode[SipayHttpStatusCode["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    SipayHttpStatusCode[SipayHttpStatusCode["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    SipayHttpStatusCode[SipayHttpStatusCode["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+})(SipayHttpStatusCode || (exports.SipayHttpStatusCode = SipayHttpStatusCode = {}));
+// Application Status Codes
+var SipayStatusCode;
+(function (SipayStatusCode) {
+    // Validation and Basic Errors
+    SipayStatusCode[SipayStatusCode["BASIC_VALIDATION"] = 1] = "BASIC_VALIDATION";
+    SipayStatusCode[SipayStatusCode["INVOICE_ID_ALREADY_PROCESSED"] = 3] = "INVOICE_ID_ALREADY_PROCESSED";
+    SipayStatusCode[SipayStatusCode["ITEMS_VALIDATION_ERROR"] = 12] = "ITEMS_VALIDATION_ERROR";
+    SipayStatusCode[SipayStatusCode["PRICE_TOTAL_MISMATCH"] = 13] = "PRICE_TOTAL_MISMATCH";
+    SipayStatusCode[SipayStatusCode["MERCHANT_NOT_FOUND"] = 14] = "MERCHANT_NOT_FOUND";
+    // Authentication and Authorization
+    SipayStatusCode[SipayStatusCode["INVALID_CREDENTIALS"] = 30] = "INVALID_CREDENTIALS";
+    SipayStatusCode[SipayStatusCode["TRANSACTION_NOT_FOUND"] = 31] = "TRANSACTION_NOT_FOUND";
+    SipayStatusCode[SipayStatusCode["INVALID_INVOICE_ID"] = 32] = "INVALID_INVOICE_ID";
+    SipayStatusCode[SipayStatusCode["QUANTITY_MUST_BE_INTEGER"] = 33] = "QUANTITY_MUST_BE_INTEGER";
+    SipayStatusCode[SipayStatusCode["PAYMENT_INTEGRATION_NOT_ALLOWED"] = 34] = "PAYMENT_INTEGRATION_NOT_ALLOWED";
+    SipayStatusCode[SipayStatusCode["CREDIT_CARD_PAYMENT_NOT_DEFINED"] = 35] = "CREDIT_CARD_PAYMENT_NOT_DEFINED";
+    // POS and Commission Errors
+    SipayStatusCode[SipayStatusCode["POS_NOT_FOUND"] = 36] = "POS_NOT_FOUND";
+    SipayStatusCode[SipayStatusCode["MERCHANT_POS_COMMISSION_NOT_SET"] = 37] = "MERCHANT_POS_COMMISSION_NOT_SET";
+    SipayStatusCode[SipayStatusCode["MERCHANT_COMMISSION_NOT_DETERMINED"] = 38] = "MERCHANT_COMMISSION_NOT_DETERMINED";
+    SipayStatusCode[SipayStatusCode["COMMISSION_NOT_FOUND"] = 39] = "COMMISSION_NOT_FOUND";
+    SipayStatusCode[SipayStatusCode["INSTALLMENT_NOT_FOUND"] = 40] = "INSTALLMENT_NOT_FOUND";
+    // Payment Errors
+    SipayStatusCode[SipayStatusCode["ORDER_FAILED"] = 41] = "ORDER_FAILED";
+    SipayStatusCode[SipayStatusCode["PAYMENT_FAILED"] = 41] = "PAYMENT_FAILED";
+    SipayStatusCode[SipayStatusCode["PRODUCT_PRICE_LESS_THAN_COMMISSION"] = 42] = "PRODUCT_PRICE_LESS_THAN_COMMISSION";
+    SipayStatusCode[SipayStatusCode["PAYMENT_TERM_NOT_SET"] = 43] = "PAYMENT_TERM_NOT_SET";
+    SipayStatusCode[SipayStatusCode["CREDIT_CARD_BLOCKED"] = 44] = "CREDIT_CARD_BLOCKED";
+    SipayStatusCode[SipayStatusCode["MERCHANT_DAILY_TRANSACTION_LIMIT_EXCEEDED"] = 44] = "MERCHANT_DAILY_TRANSACTION_LIMIT_EXCEEDED";
+    SipayStatusCode[SipayStatusCode["MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED"] = 45] = "MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED";
+    SipayStatusCode[SipayStatusCode["MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED"] = 46] = "MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED";
+    SipayStatusCode[SipayStatusCode["MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED"] = 47] = "MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED";
+    SipayStatusCode[SipayStatusCode["MINIMUM_TRANSACTION_LIMIT_VIOLATED"] = 48] = "MINIMUM_TRANSACTION_LIMIT_VIOLATED";
+    SipayStatusCode[SipayStatusCode["REFUND_FAILED"] = 49] = "REFUND_FAILED";
+    SipayStatusCode[SipayStatusCode["MAXIMUM_TRANSACTION_LIMIT_VIOLATED"] = 49] = "MAXIMUM_TRANSACTION_LIMIT_VIOLATED";
+    // Recurring Payment Errors
+    SipayStatusCode[SipayStatusCode["RECURRING_PAYMENT_VALIDATION_ERROR"] = 55] = "RECURRING_PAYMENT_VALIDATION_ERROR";
+    SipayStatusCode[SipayStatusCode["INVALID_SALE_WEBHOOK_KEY"] = 56] = "INVALID_SALE_WEBHOOK_KEY";
+    // Card and Merchant Restrictions
+    SipayStatusCode[SipayStatusCode["MERCHANT_CARD_TRANSACTION_NOT_ALLOWED"] = 60] = "MERCHANT_CARD_TRANSACTION_NOT_ALLOWED";
+    // Hash Key Errors
+    SipayStatusCode[SipayStatusCode["HASH_KEY_VALIDATION_ERROR"] = 68] = "HASH_KEY_VALIDATION_ERROR";
+    SipayStatusCode[SipayStatusCode["ORDER_NOT_YET_PROCESSED"] = 69] = "ORDER_NOT_YET_PROCESSED";
+    SipayStatusCode[SipayStatusCode["CARD_PROGRAM_MISMATCH"] = 70] = "CARD_PROGRAM_MISMATCH";
+    // Recurring Plan Errors
+    SipayStatusCode[SipayStatusCode["RECURRING_PLAN_UPDATE_FAILED"] = 71] = "RECURRING_PLAN_UPDATE_FAILED";
+    SipayStatusCode[SipayStatusCode["FAILED_TO_DELETE"] = 72] = "FAILED_TO_DELETE";
+    SipayStatusCode[SipayStatusCode["FAILED_TO_ADD_DUPLICATE_PLAN_CARD"] = 73] = "FAILED_TO_ADD_DUPLICATE_PLAN_CARD";
+    // Foreign Card Errors
+    SipayStatusCode[SipayStatusCode["FOREIGN_CARDS_NOT_ALLOWED"] = 76] = "FOREIGN_CARDS_NOT_ALLOWED";
+    SipayStatusCode[SipayStatusCode["NO_FOREIGN_CARD_COMMISSION"] = 77] = "NO_FOREIGN_CARD_COMMISSION";
+    // Token Payment Errors
+    SipayStatusCode[SipayStatusCode["MERCHANT_NOT_ALLOWED_TOKEN_PAYMENT"] = 79] = "MERCHANT_NOT_ALLOWED_TOKEN_PAYMENT";
+    SipayStatusCode[SipayStatusCode["SUB_MERCHANT_NOT_FOUND"] = 80] = "SUB_MERCHANT_NOT_FOUND";
+    SipayStatusCode[SipayStatusCode["CURRENCY_CONVERSION_FAILED"] = 81] = "CURRENCY_CONVERSION_FAILED";
+    // Card Token Errors
+    SipayStatusCode[SipayStatusCode["INVALID_CHARACTER"] = 85] = "INVALID_CHARACTER";
+    SipayStatusCode[SipayStatusCode["CARD_TOKEN_SAVE_FAILED"] = 86] = "CARD_TOKEN_SAVE_FAILED";
+    SipayStatusCode[SipayStatusCode["INVALID_TOKEN_OR_CLIENT_NUMBER"] = 87] = "INVALID_TOKEN_OR_CLIENT_NUMBER";
+    SipayStatusCode[SipayStatusCode["FAILED_TO_DELETE_CARD_TOKEN"] = 88] = "FAILED_TO_DELETE_CARD_TOKEN";
+    SipayStatusCode[SipayStatusCode["FAILED_TO_UPDATE_CARD_TOKEN"] = 89] = "FAILED_TO_UPDATE_CARD_TOKEN";
+    // Hash Key Specific Errors
+    SipayStatusCode[SipayStatusCode["INVALID_HASH_KEY"] = 90] = "INVALID_HASH_KEY";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_MERCHANT_KEY_MISMATCH"] = 91] = "HASH_KEY_MERCHANT_KEY_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_CUSTOMER_NUMBER_MISMATCH"] = 92] = "HASH_KEY_CUSTOMER_NUMBER_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_CARD_HOLDER_NAME_MISMATCH"] = 93] = "HASH_KEY_CARD_HOLDER_NAME_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_CARD_NUMBER_MISMATCH"] = 94] = "HASH_KEY_CARD_NUMBER_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_EXPIRY_MONTH_MISMATCH"] = 95] = "HASH_KEY_EXPIRY_MONTH_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_EXPIRY_YEAR_MISMATCH"] = 96] = "HASH_KEY_EXPIRY_YEAR_MISMATCH";
+    SipayStatusCode[SipayStatusCode["HASH_KEY_CARD_TOKEN_MISMATCH"] = 97] = "HASH_KEY_CARD_TOKEN_MISMATCH";
+    // General Status Codes
+    SipayStatusCode[SipayStatusCode["UNKNOWN_ERROR"] = 99] = "UNKNOWN_ERROR";
+    SipayStatusCode[SipayStatusCode["SUCCESSFUL"] = 100] = "SUCCESSFUL";
+    SipayStatusCode[SipayStatusCode["REFUND_REQUEST_CREATED"] = 101] = "REFUND_REQUEST_CREATED";
+    SipayStatusCode[SipayStatusCode["POS_NOT_DEFINED"] = 102] = "POS_NOT_DEFINED";
+    SipayStatusCode[SipayStatusCode["PAYBY_TOKEN_COMMISSION_NOT_ESTABLISHED"] = 103] = "PAYBY_TOKEN_COMMISSION_NOT_ESTABLISHED";
+    SipayStatusCode[SipayStatusCode["RETURN_TRANSACTION_ID_MUST_BE_UNIQUE"] = 104] = "RETURN_TRANSACTION_ID_MUST_BE_UNIQUE";
+    SipayStatusCode[SipayStatusCode["TRANSACTION_NOT_APPROVED"] = 105] = "TRANSACTION_NOT_APPROVED";
+    SipayStatusCode[SipayStatusCode["INVALID_MERCHANT_TYPE"] = 106] = "INVALID_MERCHANT_TYPE";
+    SipayStatusCode[SipayStatusCode["FAILED_TO_VERIFY_API_OPT"] = 107] = "FAILED_TO_VERIFY_API_OPT";
+    SipayStatusCode[SipayStatusCode["INVALID_CARD_NUMBER"] = 108] = "INVALID_CARD_NUMBER";
+    SipayStatusCode[SipayStatusCode["FILE_PROCESSING_ERROR"] = 109] = "FILE_PROCESSING_ERROR";
+    SipayStatusCode[SipayStatusCode["PARTIAL_RETURNS_NOT_ALLOWED"] = 110] = "PARTIAL_RETURNS_NOT_ALLOWED";
+    SipayStatusCode[SipayStatusCode["PARTIALLY_SUCCESSFUL"] = 112] = "PARTIALLY_SUCCESSFUL";
+    SipayStatusCode[SipayStatusCode["INVOICE_ID_ALREADY_PROCESSED_ALT"] = 117] = "INVOICE_ID_ALREADY_PROCESSED_ALT";
+    SipayStatusCode[SipayStatusCode["CANCELLATION_URL_SHOULD_NOT_BE_BLANK"] = 404] = "CANCELLATION_URL_SHOULD_NOT_BE_BLANK";
+})(SipayStatusCode || (exports.SipayStatusCode = SipayStatusCode = {}));
+// Status Code Descriptions
+exports.SipayStatusDescriptions = {
+    [SipayStatusCode.BASIC_VALIDATION]: 'Basic validation',
+    [SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED]: 'Invoice ID already processed. Order with this invoice ID process continues, Please wait or create order with new invoice id',
+    [SipayStatusCode.ITEMS_VALIDATION_ERROR]: 'Items must be an array, Invalid Currency code, Invalid item format',
+    [SipayStatusCode.PRICE_TOTAL_MISMATCH]: 'The sum of your product price does not equal the total of the invoice',
+    [SipayStatusCode.MERCHANT_NOT_FOUND]: 'Merchant not found!',
+    [SipayStatusCode.INVALID_CREDENTIALS]: 'Invalid Credentials',
+    [SipayStatusCode.TRANSACTION_NOT_FOUND]: 'Transaction not found',
+    [SipayStatusCode.INVALID_INVOICE_ID]: 'Invalid invoice ID, order not completed',
+    [SipayStatusCode.QUANTITY_MUST_BE_INTEGER]: 'Quantity must be integer',
+    [SipayStatusCode.PAYMENT_INTEGRATION_NOT_ALLOWED]: 'Payment integration method not allowed. Please contact support.',
+    [SipayStatusCode.CREDIT_CARD_PAYMENT_NOT_DEFINED]: 'Credit Card Payment Option not defined',
+    [SipayStatusCode.POS_NOT_FOUND]: 'Pos not found',
+    [SipayStatusCode.MERCHANT_POS_COMMISSION_NOT_SET]: 'Merchant Pos Commission has not been set. Please contact the service provider.',
+    [SipayStatusCode.MERCHANT_COMMISSION_NOT_DETERMINED]: 'Merchant Commission has not been determined for this currency and payment method. Please try another payment method',
+    [SipayStatusCode.COMMISSION_NOT_FOUND]: 'Commission not found',
+    [SipayStatusCode.INSTALLMENT_NOT_FOUND]: 'Installment not found',
+    [SipayStatusCode.ORDER_FAILED]: 'Order failed / Payment failed',
+    [SipayStatusCode.PRODUCT_PRICE_LESS_THAN_COMMISSION]: 'Product price less than commission, Product price less than cost',
+    [SipayStatusCode.PAYMENT_TERM_NOT_SET]: 'Payment term not set',
+    [SipayStatusCode.CREDIT_CARD_BLOCKED]: 'This credit card has been blocked. Merchant daily transaction limit exceeded',
+    [SipayStatusCode.MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED]: 'Merchant daily transaction amount limit exceeded',
+    [SipayStatusCode.MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED]: 'Merchant monthly transaction number limit exceeded',
+    [SipayStatusCode.MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED]: 'Merchant monthly transaction amount limit exceeded',
+    [SipayStatusCode.MINIMUM_TRANSACTION_LIMIT_VIOLATED]: 'Minimum transaction limit per transaction violated',
+    [SipayStatusCode.REFUND_FAILED]: 'Refund Failed. The total refund amount must not exceed the net amount. No Sales Transaction Found. Insufficient Balance. Non-refundable transaction status. Please wait at least 30 seconds for another refund. Maximum transaction limit per transaction violated',
+    [SipayStatusCode.RECURRING_PAYMENT_VALIDATION_ERROR]: 'There can be no installment sales in recurring payment. Duplicate number cannot be empty. The duplicate number must be an integer. Duplicate number must be greater than 1. The duplicate number must not be greater than 121. The iterative loop cannot be empty. The repeating loop unit is not valid.Must be "D", "M" or "Y". Duplicate range cannot be empty. The repeating range must be an integer. The repeating range must be greater than 0. The repeating range should not be greater than 99. Invalid duplicate webhook key! Please check the key name in Sipay. Duplicate webhook key cannot be empty. Please assign your webhook key to Sipay',
+    [SipayStatusCode.INVALID_SALE_WEBHOOK_KEY]: 'Invalid sale webhook key! Please check the key name in Sipay',
+    [SipayStatusCode.MERCHANT_CARD_TRANSACTION_NOT_ALLOWED]: 'The merchant is not allowed to make transactions using this card.',
+    [SipayStatusCode.HASH_KEY_VALIDATION_ERROR]: 'Total amount mismatch with hash key. Currency mismatch with hash key. Hash key and merchant key mismatch. Installment number mismatch with hash key. Hash key and pos ID mismatch. Invoice ID mismatch with hash key',
+    [SipayStatusCode.ORDER_NOT_YET_PROCESSED]: 'Order not yet processed',
+    [SipayStatusCode.CARD_PROGRAM_MISMATCH]: 'Card program mismatch',
+    [SipayStatusCode.RECURRING_PLAN_UPDATE_FAILED]: 'Recurring plan update failed, Invalid Response or Unknown Error',
+    [SipayStatusCode.FAILED_TO_DELETE]: 'Failed to delete, Failed to process old payment',
+    [SipayStatusCode.FAILED_TO_ADD_DUPLICATE_PLAN_CARD]: 'Failed to add duplicate plan card, Invalid Response or Unknown Error',
+    [SipayStatusCode.FOREIGN_CARDS_NOT_ALLOWED]: 'Foreign Cards Are Not Allowed For This Merchant.',
+    [SipayStatusCode.NO_FOREIGN_CARD_COMMISSION]: 'No Foreign Card Commission has been determined for this Merchant.',
+    [SipayStatusCode.MERCHANT_NOT_ALLOWED_TOKEN_PAYMENT]: 'The merchant is not allowed to pay with card tokens.',
+    [SipayStatusCode.SUB_MERCHANT_NOT_FOUND]: 'Sub-merchant not found',
+    [SipayStatusCode.CURRENCY_CONVERSION_FAILED]: 'Currency conversion from API failed',
+    [SipayStatusCode.INVALID_CHARACTER]: 'Invalid character',
+    [SipayStatusCode.CARD_TOKEN_SAVE_FAILED]: 'Card token save failed',
+    [SipayStatusCode.INVALID_TOKEN_OR_CLIENT_NUMBER]: 'Invalid token or client number',
+    [SipayStatusCode.FAILED_TO_DELETE_CARD_TOKEN]: 'Failed to delete card token',
+    [SipayStatusCode.FAILED_TO_UPDATE_CARD_TOKEN]: 'Failed to update card token',
+    [SipayStatusCode.INVALID_HASH_KEY]: 'Invalid Hash key',
+    [SipayStatusCode.HASH_KEY_MERCHANT_KEY_MISMATCH]: 'Hash key that does not match the Merchant key',
+    [SipayStatusCode.HASH_KEY_CUSTOMER_NUMBER_MISMATCH]: 'Hash key that does not match the customer number',
+    [SipayStatusCode.HASH_KEY_CARD_HOLDER_NAME_MISMATCH]: "Hash key that does not match the Card Holder's Name",
+    [SipayStatusCode.HASH_KEY_CARD_NUMBER_MISMATCH]: 'Hash key that does not match the Card Number',
+    [SipayStatusCode.HASH_KEY_EXPIRY_MONTH_MISMATCH]: 'Hash key that does not match expiration month',
+    [SipayStatusCode.HASH_KEY_EXPIRY_YEAR_MISMATCH]: 'Hash key that does not match expiry year',
+    [SipayStatusCode.HASH_KEY_CARD_TOKEN_MISMATCH]: 'Hash key that does not match the card token',
+    [SipayStatusCode.UNKNOWN_ERROR]: 'Unknown Error',
+    [SipayStatusCode.SUCCESSFUL]: 'Successful',
+    [SipayStatusCode.REFUND_REQUEST_CREATED]: 'Your refund request has been successfully created. Our team will complete the return process',
+    [SipayStatusCode.POS_NOT_DEFINED]: 'Pos not defined, no Pos found for this installment',
+    [SipayStatusCode.PAYBY_TOKEN_COMMISSION_NOT_ESTABLISHED]: 'Payby token commission rate not established',
+    [SipayStatusCode.RETURN_TRANSACTION_ID_MUST_BE_UNIQUE]: 'Return transaction ID must be unique',
+    [SipayStatusCode.TRANSACTION_NOT_APPROVED]: 'The transaction has not been approved',
+    [SipayStatusCode.INVALID_MERCHANT_TYPE]: 'Invalid merchant type',
+    [SipayStatusCode.FAILED_TO_VERIFY_API_OPT]: 'Failed to verify submitted API opt',
+    [SipayStatusCode.INVALID_CARD_NUMBER]: 'Invalid card number',
+    [SipayStatusCode.FILE_PROCESSING_ERROR]: 'File processing error',
+    [SipayStatusCode.PARTIAL_RETURNS_NOT_ALLOWED]: 'Partial returns are not allowed for this transaction.',
+    [SipayStatusCode.PARTIALLY_SUCCESSFUL]: 'Partially successful',
+    [SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED_ALT]: 'The invoice id already processed',
+    [SipayStatusCode.CANCELLATION_URL_SHOULD_NOT_BE_BLANK]: 'Cancellation URL should not be blank',
+};
+// Status Code Categories
+var SipayStatusCategory;
+(function (SipayStatusCategory) {
+    SipayStatusCategory["SUCCESS"] = "success";
+    SipayStatusCategory["VALIDATION_ERROR"] = "validation_error";
+    SipayStatusCategory["AUTHENTICATION_ERROR"] = "authentication_error";
+    SipayStatusCategory["PAYMENT_ERROR"] = "payment_error";
+    SipayStatusCategory["MERCHANT_ERROR"] = "merchant_error";
+    SipayStatusCategory["CARD_ERROR"] = "card_error";
+    SipayStatusCategory["HASH_ERROR"] = "hash_error";
+    SipayStatusCategory["RECURRING_ERROR"] = "recurring_error";
+    SipayStatusCategory["SYSTEM_ERROR"] = "system_error";
+})(SipayStatusCategory || (exports.SipayStatusCategory = SipayStatusCategory = {}));
+/**
+ * Categorize status codes for better error handling
+ */
+function getStatusCategory(statusCode) {
+    switch (statusCode) {
+        case SipayStatusCode.SUCCESSFUL:
+        case SipayStatusCode.REFUND_REQUEST_CREATED:
+        case SipayStatusCode.PARTIALLY_SUCCESSFUL:
+            return SipayStatusCategory.SUCCESS;
+        case SipayStatusCode.BASIC_VALIDATION:
+        case SipayStatusCode.ITEMS_VALIDATION_ERROR:
+        case SipayStatusCode.PRICE_TOTAL_MISMATCH:
+        case SipayStatusCode.QUANTITY_MUST_BE_INTEGER:
+        case SipayStatusCode.INVALID_INVOICE_ID:
+        case SipayStatusCode.INVALID_CHARACTER:
+        case SipayStatusCode.INVALID_CARD_NUMBER:
+        case SipayStatusCode.CANCELLATION_URL_SHOULD_NOT_BE_BLANK:
+            return SipayStatusCategory.VALIDATION_ERROR;
+        case SipayStatusCode.INVALID_CREDENTIALS:
+        case SipayStatusCode.PAYMENT_INTEGRATION_NOT_ALLOWED:
+        case SipayStatusCode.MERCHANT_NOT_ALLOWED_TOKEN_PAYMENT:
+        case SipayStatusCode.INVALID_TOKEN_OR_CLIENT_NUMBER:
+            return SipayStatusCategory.AUTHENTICATION_ERROR;
+        case SipayStatusCode.ORDER_FAILED:
+        case SipayStatusCode.PAYMENT_FAILED:
+        case SipayStatusCode.PAYMENT_TERM_NOT_SET:
+        case SipayStatusCode.REFUND_FAILED:
+        case SipayStatusCode.TRANSACTION_NOT_FOUND:
+        case SipayStatusCode.ORDER_NOT_YET_PROCESSED:
+        case SipayStatusCode.TRANSACTION_NOT_APPROVED:
+            return SipayStatusCategory.PAYMENT_ERROR;
+        case SipayStatusCode.MERCHANT_NOT_FOUND:
+        case SipayStatusCode.MERCHANT_POS_COMMISSION_NOT_SET:
+        case SipayStatusCode.MERCHANT_COMMISSION_NOT_DETERMINED:
+        case SipayStatusCode.MERCHANT_DAILY_TRANSACTION_LIMIT_EXCEEDED:
+        case SipayStatusCode.MERCHANT_DAILY_AMOUNT_LIMIT_EXCEEDED:
+        case SipayStatusCode.MERCHANT_MONTHLY_TRANSACTION_LIMIT_EXCEEDED:
+        case SipayStatusCode.MERCHANT_MONTHLY_AMOUNT_LIMIT_EXCEEDED:
+        case SipayStatusCode.MINIMUM_TRANSACTION_LIMIT_VIOLATED:
+        case SipayStatusCode.SUB_MERCHANT_NOT_FOUND:
+        case SipayStatusCode.INVALID_MERCHANT_TYPE:
+            return SipayStatusCategory.MERCHANT_ERROR;
+        case SipayStatusCode.CREDIT_CARD_BLOCKED:
+        case SipayStatusCode.MERCHANT_CARD_TRANSACTION_NOT_ALLOWED:
+        case SipayStatusCode.CARD_PROGRAM_MISMATCH:
+        case SipayStatusCode.FOREIGN_CARDS_NOT_ALLOWED:
+        case SipayStatusCode.NO_FOREIGN_CARD_COMMISSION:
+        case SipayStatusCode.CARD_TOKEN_SAVE_FAILED:
+        case SipayStatusCode.FAILED_TO_DELETE_CARD_TOKEN:
+        case SipayStatusCode.FAILED_TO_UPDATE_CARD_TOKEN:
+            return SipayStatusCategory.CARD_ERROR;
+        case SipayStatusCode.HASH_KEY_VALIDATION_ERROR:
+        case SipayStatusCode.INVALID_HASH_KEY:
+        case SipayStatusCode.HASH_KEY_MERCHANT_KEY_MISMATCH:
+        case SipayStatusCode.HASH_KEY_CUSTOMER_NUMBER_MISMATCH:
+        case SipayStatusCode.HASH_KEY_CARD_HOLDER_NAME_MISMATCH:
+        case SipayStatusCode.HASH_KEY_CARD_NUMBER_MISMATCH:
+        case SipayStatusCode.HASH_KEY_EXPIRY_MONTH_MISMATCH:
+        case SipayStatusCode.HASH_KEY_EXPIRY_YEAR_MISMATCH:
+        case SipayStatusCode.HASH_KEY_CARD_TOKEN_MISMATCH:
+            return SipayStatusCategory.HASH_ERROR;
+        case SipayStatusCode.RECURRING_PAYMENT_VALIDATION_ERROR:
+        case SipayStatusCode.RECURRING_PLAN_UPDATE_FAILED:
+        case SipayStatusCode.FAILED_TO_ADD_DUPLICATE_PLAN_CARD:
+            return SipayStatusCategory.RECURRING_ERROR;
+        default:
+            return SipayStatusCategory.SYSTEM_ERROR;
+    }
+}
+/**
+ * Check if a status code indicates success
+ */
+function isSuccessStatus(statusCode) {
+    return getStatusCategory(statusCode) === SipayStatusCategory.SUCCESS;
+}
+/**
+ * Check if a status code indicates an error
+ */
+function isErrorStatus(statusCode) {
+    return !isSuccessStatus(statusCode);
+}
+/**
+ * Get human-readable description for a status code
+ */
+function getStatusDescription(statusCode) {
+    return exports.SipayStatusDescriptions[statusCode] || 'Unknown status code';
+}
+/**
+ * Check if status code is retryable (temporary errors)
+ */
+function isRetryableStatus(statusCode) {
+    const retryableStatusCodes = [
+        SipayStatusCode.ORDER_NOT_YET_PROCESSED,
+        SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED,
+        SipayStatusCode.INVOICE_ID_ALREADY_PROCESSED_ALT,
+        SipayStatusCode.MAXIMUM_TRANSACTION_LIMIT_VIOLATED,
+    ];
+    return retryableStatusCodes.includes(statusCode);
+}
+//# sourceMappingURL=status-codes.js.map

package/dist/types/status-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-codes.js","sourceRoot":"","sources":["../../src/types/status-codes.ts"],"names":[],"mappings":"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"}

package/dist/utils/http-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAc,cAAc,EAAE,MAAM,UAAU,CAAC;AAErF,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,MAAM,EAAE,WAAW;IAiCzB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAoB7B,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAqBzB,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzB,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAyB/B,OAAO,CAAC,gBAAgB;IAmBxB,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG9B"}
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,gBAAgB,EAEhB,cAAc,EAKf,MAAM,UAAU,CAAC;AAElB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAS;gBAEX,MAAM,EAAE,WAAW;IAiCzB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB7B,OAAO,CAAC,CAAC,GAAG,GAAG,EACnB,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAqBzB,GAAG,CAAC,CAAC,GAAG,GAAG,EACf,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,GAAG,EACZ,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzB,IAAI,CAAC,CAAC,GAAG,GAAG,EAChB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAIzB,QAAQ,CAAC,CAAC,GAAG,GAAG,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,GAAG,EACV,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAyB/B,OAAO,CAAC,gBAAgB;IA+BxB,QAAQ,IAAI,MAAM,GAAG,SAAS;IAI9B,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAG9B"}

package/dist/utils/http-client.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SipayHttpClient = void 0;
 const axios_1 = __importDefault(require("axios"));
+const types_1 = require("../types");
 class SipayHttpClient {
     constructor(config) {
         this.config = {
@@ -102,10 +103,20 @@ class SipayHttpClient {
         sipayError.type = 'SipayError';
         if (error.response?.data) {
             const errorData = error.response.data;
+            const statusCode = errorData.status_code;
             sipayError.message =
-                errorData.status_description || errorData.message || 'Unknown Sipay error';
-            sipayError.status_code = errorData.status_code;
-            sipayError.status_description = errorData.status_description;
+                errorData.status_description ||
+                    errorData.message ||
+                    (0, types_1.getStatusDescription)(statusCode) ||
+                    'Unknown Sipay error';
+            sipayError.status_code = statusCode;
+            sipayError.status_description =
+                errorData.status_description || (0, types_1.getStatusDescription)(statusCode);
+            // Add status code metadata
+            if (statusCode) {
+                sipayError.category = (0, types_1.getStatusCategory)(statusCode);
+                sipayError.isRetryable = (0, types_1.isRetryableStatus)(statusCode);
+            }
         }
         else if (error.request) {
             sipayError.message = 'Network error: No response received from Sipay';

package/dist/utils/http-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"http-client.js","sourceRoot":"","sources":["../../src/utils/http-client.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -2,18 +2,51 @@
  * Utility functions for Sipay SDK
  */
 /**
- * Generate hash key for payment requests
- * Based on Sipay documentation requirements
+ * Validate credit card number using Luhn algorithm
  */
-export declare function generateHashKey(merchantKey: string, invoiceId: string, amount: number, secretKey: string): string;
+export declare function luhnCheck(cardNumber: string): boolean;
 /**
- * Validate credit card number using Luhn algorithm
+ * Validate credit card number (alias for luhnCheck)
  */
 export declare function validateCreditCard(cardNumber: string): boolean;
 /**
- * Format currency amount for Sipay API
+ * Mask credit card number for display
+ */
+export declare function maskCardNumber(cardNumber: string): string;
+/**
+ * Format amount for Sipay API - amounts should be sent as numbers, not cents
  */
 export declare function formatAmount(amount: number): string;
+/**
+ * Format amount specifically for hash key generation
+ * This should match PHP's number_format($amount, 2, ".", "") exactly
+ * PHP always formats with 2 decimal places: 10.00, 125.50, etc.
+ */
+export declare function formatAmountForHash(amount: number): string;
+/**
+ * Generate hash key for payment requests
+ * Order matches PHP SDK CreateNonSecurePaymentRequest::generateHashKeyParts():
+ * 1. total, 2. installments_number, 3. currency_code, 4. merchant_key, 5. invoice_id
+ */
+export declare function generatePaymentHashKey(total: number, installment: number, currencyCode: string, merchantKey: string, invoiceId: string, apiSecret: string): string;
+/**
+ * Generate hash key for status check requests
+ * Order matches PHP SDK CheckTransactionStatusRequest::generateHashKeyParts():
+ * 1. invoice_id, 2. merchant_key
+ */
+export declare function generateStatusHashKey(invoiceId: string, merchantKey: string, apiSecret: string): string;
+/**
+ * Generate hash key for payment confirmation requests
+ * Order matches PHP SDK: merchant_key|invoice_id|status
+ */
+export declare function generateConfirmPaymentHashKey(merchantKey: string, invoiceId: string, status: number, apiSecret: string): string;
+/**
+ * Generate hash key for payment requests
+ * Exact 1:1 Node.js implementation of PHP's generateHashKey function
+ * Matches: $total . '|' . $installment . '|' . $currency_code . '|' . $merchant_key . '|' . $invoice_id
+ * with openssl_encrypt('aes-256-cbc') encryption
+ */
+export declare function generateHashKey(parts: (string | number)[], appSecret: string): string;
 /**
  * Generate a unique invoice ID
  */
@@ -33,4 +66,16 @@ export declare function parseSipayError(error: any): {
     code: number;
     message: string;
 };
+/**
+ * Validate hash key using server-side validation logic
+ * This matches exactly what the PHP SDK does for server-side validation
+ * Expected decrypted format: status|total|invoiceId|orderId|currencyCode
+ */
+export declare function validateHashKey(hashKey: string, secretKey: string): [string, number, string, number, string];
+/**
+ * Generate hash key in server validation format
+ * Server expects: status|total|invoiceId|orderId|currencyCode
+ */
+export declare function generateServerFormatHashKey(status: string, total: number, invoiceId: string, orderId: number, currencyCode: string, appSecret: string): string;
+export * from './status-code-helpers';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA;;GAEG;AAEH;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAGR;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA0B9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,CAsDvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAmBzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAa7E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAGA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CA0BrD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAInD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG1D;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,MAAM,CAUR;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CA4BrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,SAAQ,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,GAAG,GAAG,MAAM,EAAE,CAsDvD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAmBzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,GAAG,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAa7E;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAsD1C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAChB,MAAM,CAIR;AAGD,cAAc,uBAAuB,CAAC"}