@muhammedaksam/sipay-node 1.0.6 → 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":";;;;;;AAAA,kDAAgF;AAGhF,MAAa,eAAe;IAK1B,YAAY,MAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,6CAA6C;YACtD,OAAO,EAAE,KAAK;YACd,GAAG,MAAM;SACV,CAAC;QAEF,IAAI,CAAC,MAAM,GAAG,eAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;aACnC;SACF,CAAC,CAAC;QAEH,wCAAwC;QACxC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC9C,IAAI,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,GAAG,KAAK,YAAY,EAAE,CAAC;gBAC9C,MAAM,CAAC,OAAO,CAAC,aAAa,GAAG,UAAU,IAAI,CAAC,KAAK,EAAE,CAAC;YACxD,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC;QAEH,0CAA0C;QAC1C,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CACnC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EACtB,CAAC,KAAK,EAAE,EAAE;YACR,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACrC,YAAY,EACZ;gBACE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;gBACzB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;aAClC,CACF,CAAC;YAEF,IAAI,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;gBACnE,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,kBAAkB,IAAI,uBAAuB,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CACX,MAAsB,EACtB,GAAW,EACX,IAAU,EACV,OAAwB;QAExB,sDAAsD;QACtD,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,GAAG,KAAK,YAAY,EAAE,CAAC;YACxC,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC5B,CAAC;QAED,MAAM,MAAM,GAAuB;YACjC,MAAM;YACN,GAAG;YACH,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;YACrB,GAAG,OAAO;SACX,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAuC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YACvF,OAAO,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,GAAG,CACP,GAAW,EACX,MAAY,EACZ,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAI,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,GAAW,EACX,IAAU,EACV,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,GAAW,EACX,IAAU,EACV,OAAwB;QAExB,MAAM,WAAW,GAAG;YAClB,GAAG,OAAO;YACV,OAAO,EAAE;gBACP,GAAG,OAAO,EAAE,OAAO;gBACnB,cAAc,EAAE,mCAAmC;aACpD;SACF,CAAC;QAEF,2CAA2C;QAC3C,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,eAAe,EAAE,CAAC;YACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACtD,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC9C,CAAC;qBAAM,CAAC;oBACN,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;gBACtC,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC,QAAQ,EAAE,EAAE,WAAW,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;IACzD,CAAC;IAEO,gBAAgB,CAAC,KAAU;QACjC,MAAM,UAAU,GAAG,IAAI,KAAK,EAAgB,CAAC;QAC7C,UAAU,CAAC,IAAI,GAAG,YAAY,CAAC;QAE/B,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YACtC,UAAU,CAAC,OAAO;gBAChB,SAAS,CAAC,kBAAkB,IAAI,SAAS,CAAC,OAAO,IAAI,qBAAqB,CAAC;YAC7E,UAAU,CAAC,WAAW,GAAG,SAAS,CAAC,WAAW,CAAC;YAC/C,UAAU,CAAC,kBAAkB,GAAG,SAAS,CAAC,kBAAkB,CAAC;QAC/D,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACzB,UAAU,CAAC,OAAO,GAAG,gDAAgD,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,wBAAwB,CAAC;QACjE,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AA3JD,0CA2JC"}
+{"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

@@ -19,7 +19,8 @@ export declare function maskCardNumber(cardNumber: string): string;
 export declare function formatAmount(amount: number): string;
 /**
  * Format amount specifically for hash key generation
- * This should match PHP's format exactly: just the number as-is, no forced decimals
+ * 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;
 /**
@@ -35,8 +36,15 @@ export declare function generatePaymentHashKey(total: number, installment: numbe
  */
 export declare function generateStatusHashKey(invoiceId: string, merchantKey: string, apiSecret: string): string;
 /**
- * Generate hash key for payment requests based on official Sipay documentation
- * This matches exactly the official JavaScript implementation in sipayEn.yaml
+ * 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;
 /**
@@ -69,4 +77,5 @@ export declare function validateHashKey(hashKey: string, secretKey: string): [st
  * 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;;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;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAK1D;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,eAAe,CAAC,KAAK,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAsCrF;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"}
+{"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"}

package/dist/utils/index.js

@@ -1,4 +1,40 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.luhnCheck = luhnCheck;
 exports.validateCreditCard = validateCreditCard;
@@ -7,6 +43,7 @@ exports.formatAmount = formatAmount;
 exports.formatAmountForHash = formatAmountForHash;
 exports.generatePaymentHashKey = generatePaymentHashKey;
 exports.generateStatusHashKey = generateStatusHashKey;
+exports.generateConfirmPaymentHashKey = generateConfirmPaymentHashKey;
 exports.generateHashKey = generateHashKey;
 exports.generateInvoiceId = generateInvoiceId;
 exports.validatePaymentData = validatePaymentData;
@@ -14,7 +51,8 @@ exports.maskCreditCard = maskCreditCard;
 exports.parseSipayError = parseSipayError;
 exports.validateHashKey = validateHashKey;
 exports.generateServerFormatHashKey = generateServerFormatHashKey;
-const crypto_1 = require("crypto");
+const crypto = __importStar(require("crypto"));
+const { createHash, createCipheriv, createDecipheriv } = crypto;
 /**
  * Utility functions for Sipay SDK
  */
@@ -70,13 +108,12 @@ function formatAmount(amount) {
 }
 /**
  * Format amount specifically for hash key generation
- * This should match PHP's format exactly: just the number as-is, no forced decimals
+ * This should match PHP's number_format($amount, 2, ".", "") exactly
+ * PHP always formats with 2 decimal places: 10.00, 125.50, etc.
  */
 function formatAmountForHash(amount) {
-    // PHP uses: $total.'|' - which converts number to string without forcing decimal places
-    // For integer amounts like 10, PHP outputs "10", not "10.00"
-    // For decimal amounts like 10.5, PHP outputs "10.5", not "10.50"
-    return amount.toString();
+    // Match PHP number_format($amount, 2, ".", "") - always 2 decimal places
+    return amount.toFixed(2);
 }
 /**
  * Generate hash key for payment requests
@@ -103,37 +140,40 @@ function generateStatusHashKey(invoiceId, merchantKey, apiSecret) {
     return generateHashKey(parts, apiSecret);
 }
 /**
- * Generate hash key for payment requests based on official Sipay documentation
- * This matches exactly the official JavaScript implementation in sipayEn.yaml
+ * Generate hash key for payment confirmation requests
+ * Order matches PHP SDK: merchant_key|invoice_id|status
+ */
+function generateConfirmPaymentHashKey(merchantKey, invoiceId, status, apiSecret) {
+    const parts = [merchantKey, invoiceId, status.toString()];
+    return generateHashKey(parts, apiSecret);
+}
+/**
+ * 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
  */
 function generateHashKey(parts, appSecret) {
-    try {
-        // Join parts with pipe separator - exactly like official: data = total + '|' + ...
-        const data = parts.join('|');
-        // Generate random IV - exactly like official: crypto.createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 16)
-        const iv = (0, crypto_1.createHash)('sha1').update(String(Math.random())).digest('hex').slice(0, 16);
-        // Create password hash from app secret - exactly like official: crypto.createHash('sha1').update(app_secret).digest('hex')
-        const password = (0, crypto_1.createHash)('sha1').update(appSecret).digest('hex');
-        // Generate random salt - exactly like official: crypto.createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 4)
-        const salt = (0, crypto_1.createHash)('sha1').update(String(Math.random())).digest('hex').slice(0, 4);
-        // Create salt with password - get full 32-byte key
-        const saltWithPasswordHash = (0, crypto_1.createHash)('sha256')
-            .update(password + salt)
-            .digest(); // Get Buffer directly, not hex string
-        // Encrypt data using AES-256-CBC - exactly like official implementation
-        const cipher = (0, crypto_1.createCipheriv)('aes-256-cbc', saltWithPasswordHash, // Use Buffer directly
-        Buffer.from(iv, 'ascii'));
-        // Official uses: cipher.update(padded_data, 'binary', 'base64'); cipher.final('base64');
-        let encrypted = cipher.update(data, 'binary', 'base64');
-        encrypted += cipher.final('base64');
-        // Format the final hash key - exactly like official: iv + ':' + salt + ':' + encrypted
-        const msgBundle = `${iv}:${salt}:${encrypted}`;
-        // Replace / with __ - exactly like official: msg_encrypted_bundle.replace('/', '__')
-        return msgBundle.replace(/\//g, '__');
-    }
-    catch (error) {
-        throw new Error(`Hash key generation failed: ${error}`);
-    }
+    const data = parts.join('|');
+    // Generate IV using SHA1 hash of random value
+    const iv = createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 16);
+    // Generate password using SHA1 hash of app secret
+    const password = createHash('sha1').update(appSecret).digest('hex');
+    // Generate salt using SHA1 hash of random value
+    const salt = createHash('sha1').update(String(Math.random())).digest('hex').slice(0, 4);
+    // Create encryption key using SHA256 hash of password and salt
+    const saltWithPassword = createHash('sha256')
+        .update(password + salt)
+        .digest('hex')
+        .slice(0, 32);
+    // Encrypt data using AES-256-CBC
+    const cipher = createCipheriv('aes-256-cbc', saltWithPassword, iv);
+    let encrypted = cipher.update(data, 'binary', 'base64');
+    encrypted += cipher.final('base64');
+    // Bundle components and replace forward slashes with double underscores
+    let msgEncryptedBundle = `${iv}:${salt}:${encrypted}`;
+    msgEncryptedBundle = msgEncryptedBundle.replace(/\//g, '__');
+    return msgEncryptedBundle;
 }
 /**
  * Generate a unique invoice ID
@@ -245,21 +285,21 @@ function validateHashKey(hashKey, secretKey) {
     try {
         // Replace underscores with forward slashes (PHP compatibility)
         const normalizedHashKey = hashKey.replace(/_/g, '/');
-        const password = (0, crypto_1.createHash)('sha1').update(secretKey).digest('hex');
+        const password = createHash('sha1').update(secretKey).digest('hex');
         const components = normalizedHashKey.split(':');
         if (components.length > 2) {
             const iv = components[0] || '';
             const saltHex = components[1] || '';
             const encryptedMsg = components[2] || '';
             // Generate salt exactly like PHP: hash('sha256', $password . $salt)
-            const saltWithPassword = (0, crypto_1.createHash)('sha256')
+            const saltWithPassword = createHash('sha256')
                 .update(password + saltHex)
                 .digest('hex');
             // Create decipher with proper parameters
             // PHP's openssl_decrypt expects:
             // - IV as raw ASCII bytes (16-char hex string treated as ASCII)
             // - Key as binary from hex string (32 bytes for AES-256)
-            const decipher = (0, crypto_1.createDecipheriv)('aes-256-cbc', Buffer.from(saltWithPassword, 'hex').slice(0, 32), // 32-byte key from hex
+            const decipher = createDecipheriv('aes-256-cbc', Buffer.from(saltWithPassword, 'hex').slice(0, 32), // 32-byte key from hex
             Buffer.from(iv, 'ascii') // IV: 16-char hex string as ASCII bytes
             );
             let decrypted = decipher.update(encryptedMsg, 'base64', 'utf8');
@@ -287,4 +327,6 @@ function generateServerFormatHashKey(status, total, invoiceId, orderId, currency
     const parts = [status, formatAmountForHash(total), invoiceId, orderId.toString(), currencyCode];
     return generateHashKey(parts, appSecret);
 }
+// Export status code helpers
+__exportStar(require("./status-code-helpers"), exports);
 //# sourceMappingURL=index.js.map