@plyaz/types 1.15.8 → 1.15.10

package/dist/errors/codes.d.ts

@@ -210,6 +210,15 @@ export declare const ERROR_CODES: {
     readonly PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid";
     readonly PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout";
     readonly PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed";
+    readonly PAYMENT_PROVIDER_RATE_LIMIT: "payment.provider.rate.limit";
+    readonly PAYMENT_PROVIDER_UNKNOWN: "payment.provider.unknown";
+    readonly PAYMENT_CUSTOMER_CREATION_FAILED: "payment.customer.creation.failed";
+    readonly PAYMENT_METHOD_SAVE_FAILED: "payment.method.save.failed";
+    readonly PAYMENT_METHOD_DELETE_FAILED: "payment.method.delete.failed";
+    readonly PAYMENT_SUBSCRIPTION_CREATE_FAILED: "payment.subscription.create.failed";
+    readonly PAYMENT_SUBSCRIPTION_CANCEL_FAILED: "payment.subscription.cancel.failed";
+    readonly PAYMENT_PAYOUT_FAILED: "payment.payout.failed";
+    readonly PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: "payment.transaction.history.fetch.failed";
     readonly PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation";
     readonly PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed";
     readonly PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded";
@@ -398,81 +407,86 @@ export declare const NOTIFICATION_ERROR_CODES: {
  * Subset of ERROR_CODES for @plyaz/payments package
  */
 export declare const PAYMENT_ERROR_CODES: {
-    PAYMENT_TIMEOUT: string;
-    PAYMENT_NETWORK_ERROR: string;
-    PAYMENT_REFUND_FAILED: string;
-    PAYMENT_REFUND_NOT_FOUND: string;
-    PAYMENT_REFUND_ALREADY_PROCESSED: string;
-    PAYMENT_REFUND_AMOUNT_INVALID: string;
-    PAYMENT_REFUND_VALIDATION_FAILED: string;
-    PAYMENT_REFUND_TIMEOUT: string;
-    PAYMENT_REFUND_NOT_ALLOWED: string;
-    PAYMENT_REFUND_AUTHORIZATION_FAILED: string;
-    PAYMENT_REFUND_PROCESSING_FAILED: string;
-    PAYMENT_PROVIDER_ERROR: string;
-    PAYMENT_PROVIDER_UNAVAILABLE: string;
-    PAYMENT_PROVIDER_CONFIGURATION_INVALID: string;
-    PAYMENT_PROVIDER_RESPONSE_INVALID: string;
-    PAYMENT_PROVIDER_TIMEOUT: string;
-    PAYMENT_PROVIDER_AUTH_FAILED: string;
-    PAYMENT_COMPLIANCE_VIOLATION: string;
-    PAYMENT_COMPLIANCE_CHECK_FAILED: string;
-    PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: string;
-    PAYMENT_COMPLIANCE_POLICY_MISSING: string;
-    PAYMENT_COMPLIANCE_KYC_REQUIRED: string;
-    PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: string;
-    PAYMENT_PROCESSING_FAILED: string;
-    PAYMENT_PROCESSING_TIMEOUT: string;
-    PAYMENT_PROCESSING_GATEWAY_ERROR: string;
-    PAYMENT_PROCESSING_DUPLICATE: string;
-    PAYMENT_PROCESSING_UNEXPECTED_STATE: string;
-    PAYMENT_SECURITY_VIOLATION: string;
-    PAYMENT_SECURITY_SIGNATURE_INVALID: string;
-    PAYMENT_SECURITY_ENCRYPTION_FAILED: string;
-    PAYMENT_SECURITY_FRAUD_DETECTED: string;
-    PAYMENT_SECURITY_TOKEN_INVALID: string;
-    PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: string;
-    PAYMENT_VALIDATION_FAILED: string;
-    PAYMENT_VALIDATION_AMOUNT_INVALID: string;
-    PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: string;
-    PAYMENT_VALIDATION_METADATA_INVALID: string;
-    PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: string;
-    PAYMENT_WEBHOOK_SIGNATURE_INVALID: string;
-    PAYMENT_WEBHOOK_PROCESSING_FAILED: string;
-    PAYMENT_WEBHOOK_VALIDATION_FAILED: string;
-    PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: string;
-    PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: string;
-    PAYMENT_ADAPTER_INIT_FAILED: string;
-    PAYMENT_ADAPTER_SHUTDOWN_ERROR: string;
-    PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: string;
-    PAYMENT_ADAPTER_MISSING_PROVIDER: string;
-    PAYMENT_ADAPTER_MISSING_ENVIRONMENT: string;
-    PAYMENT_ADAPTER_MISSING_CREDENTIALS: string;
-    PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: string;
-    PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: string;
-    PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: string;
-    PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: string;
-    PAYMENT_IDEMPOTENCY_VIOLATION: string;
-    PAYMENT_IDEMPOTENCY_KEY_MISSING: string;
-    PAYMENT_IDEMPOTENCY_STORE_ERROR: string;
-    PAYMENT_ROUTING_FAILED: string;
-    PAYMENT_ROUTING_CONFIGURATION_INVALID: string;
-    PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: string;
-    PAYMENT_ROUTING_RETRY_EXCEEDED: string;
-    PAYMENT_SYSTEM_NOT_INITIALIZED: string;
-    PAYMENT_CONTEXT_OPERATION_FAILED: string;
-    PAYMENT_INTERNAL_ERROR: string;
-    PAYMENT_UNKNOWN_ERROR: string;
-    /**
-     * Thrown when an event could not be emitted due to internal state or creation errors.
-     * Typically non-retryable, indicates a logic or validation fault.
-     */
-    PAYMENT_EVENT_EMIT_FAILED: string;
-    PAYMENT_EVENT_INVALID_TYPE: string;
-    PAYMENT_EVENT_CREATION_FAILED: string;
-    PAYMENT_EVENT_HANDLER_TIMEOUT: string;
-    PAYMENT_EVENT_HANDLER_INVALID_RESULT: string;
-    PAYMENT_EVENT_LIFECYCLE_FAILURE: string;
+    readonly PAYMENT_TIMEOUT: "payment.timeout";
+    readonly PAYMENT_NETWORK_ERROR: "payment.network.error";
+    readonly PAYMENT_REFUND_FAILED: "payment.refund.failed";
+    readonly PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found";
+    readonly PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed";
+    readonly PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid";
+    readonly PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed";
+    readonly PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout";
+    readonly PAYMENT_REFUND_NOT_ALLOWED: "payment.refund.not.allowed";
+    readonly PAYMENT_REFUND_AUTHORIZATION_FAILED: "payment.refund.authorization.failed";
+    readonly PAYMENT_REFUND_PROCESSING_FAILED: "payment.refund.processing.failed";
+    readonly PAYMENT_PROVIDER_ERROR: "payment.provider.error";
+    readonly PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable";
+    readonly PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid";
+    readonly PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid";
+    readonly PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout";
+    readonly PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed";
+    readonly PAYMENT_PROVIDER_RATE_LIMIT: "payment.provider.rate.limit";
+    readonly PAYMENT_PROVIDER_UNKNOWN: "payment.provider.unknown";
+    readonly PAYMENT_CUSTOMER_CREATION_FAILED: "payment.customer.creation.failed";
+    readonly PAYMENT_METHOD_SAVE_FAILED: "payment.method.save.failed";
+    readonly PAYMENT_METHOD_DELETE_FAILED: "payment.method.delete.failed";
+    readonly PAYMENT_SUBSCRIPTION_CREATE_FAILED: "payment.subscription.create.failed";
+    readonly PAYMENT_SUBSCRIPTION_CANCEL_FAILED: "payment.subscription.cancel.failed";
+    readonly PAYMENT_PAYOUT_FAILED: "payment.payout.failed";
+    readonly PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: "payment.transaction.history.fetch.failed";
+    readonly PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation";
+    readonly PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed";
+    readonly PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded";
+    readonly PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing";
+    readonly PAYMENT_COMPLIANCE_KYC_REQUIRED: "payment.compliance.kyc.required";
+    readonly PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: "payment.compliance.geographic.restriction";
+    readonly PAYMENT_PROCESSING_FAILED: "payment.processing.failed";
+    readonly PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout";
+    readonly PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error";
+    readonly PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate";
+    readonly PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state";
+    readonly PAYMENT_SECURITY_VIOLATION: "payment.security.violation";
+    readonly PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid";
+    readonly PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed";
+    readonly PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected";
+    readonly PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid";
+    readonly PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: "payment.security.velocity.limit.exceeded";
+    readonly PAYMENT_VALIDATION_FAILED: "payment.validation.failed";
+    readonly PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid";
+    readonly PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported";
+    readonly PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid";
+    readonly PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required";
+    readonly PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid";
+    readonly PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed";
+    readonly PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed";
+    readonly PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported";
+    readonly PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found";
+    readonly PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed";
+    readonly PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error";
+    readonly PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed";
+    readonly PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider";
+    readonly PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment";
+    readonly PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials";
+    readonly PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url";
+    readonly PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint";
+    readonly PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation";
+    readonly PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed";
+    readonly PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation";
+    readonly PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing";
+    readonly PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error";
+    readonly PAYMENT_ROUTING_FAILED: "payment.routing.failed";
+    readonly PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid";
+    readonly PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable";
+    readonly PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded";
+    readonly PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized";
+    readonly PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed";
+    readonly PAYMENT_INTERNAL_ERROR: "payment.internal.error";
+    readonly PAYMENT_UNKNOWN_ERROR: "payment.unknown.error";
+    readonly PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED";
+    readonly PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE";
+    readonly PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED";
+    readonly PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT";
+    readonly PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT";
+    readonly PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE";
 };
 /** Database-specific error codes
  * Subset of ERROR_CODES for database operations

package/dist/errors/index.cjs

@@ -594,6 +594,20 @@ var ERROR_CODES = {
   PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid",
   PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout",
   PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed",
+  PAYMENT_PROVIDER_RATE_LIMIT: "payment.provider.rate.limit",
+  // for HTTP 429
+  PAYMENT_PROVIDER_UNKNOWN: "payment.provider.unknown",
+  PAYMENT_CUSTOMER_CREATION_FAILED: "payment.customer.creation.failed",
+  // Payment method errors
+  PAYMENT_METHOD_SAVE_FAILED: "payment.method.save.failed",
+  PAYMENT_METHOD_DELETE_FAILED: "payment.method.delete.failed",
+  // Subscription errors
+  PAYMENT_SUBSCRIPTION_CREATE_FAILED: "payment.subscription.create.failed",
+  PAYMENT_SUBSCRIPTION_CANCEL_FAILED: "payment.subscription.cancel.failed",
+  // Payout errors
+  PAYMENT_PAYOUT_FAILED: "payment.payout.failed",
+  // Transaction history errors
+  PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: "payment.transaction.history.fetch.failed",
   // Compliance
   PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation",
   PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed",
@@ -775,92 +789,103 @@ var NOTIFICATION_ERROR_CODES = {
   INITIALIZATION_FAILED: ERROR_CODES.NOTIFICATION_INITIALIZATION_FAILED
 };
 var PAYMENT_ERROR_CODES = {
-  PAYMENT_TIMEOUT: "payment.timeout",
-  PAYMENT_NETWORK_ERROR: "payment.network.error",
+  // Timeout & Network
+  PAYMENT_TIMEOUT: ERROR_CODES.PAYMENT_TIMEOUT,
+  PAYMENT_NETWORK_ERROR: ERROR_CODES.PAYMENT_NETWORK_ERROR,
   // Refund
-  PAYMENT_REFUND_FAILED: "payment.refund.failed",
-  PAYMENT_REFUND_NOT_FOUND: "payment.refund.not.found",
-  PAYMENT_REFUND_ALREADY_PROCESSED: "payment.refund.already.processed",
-  PAYMENT_REFUND_AMOUNT_INVALID: "payment.refund.amount.invalid",
-  PAYMENT_REFUND_VALIDATION_FAILED: "payment.refund.validation.failed",
-  PAYMENT_REFUND_TIMEOUT: "payment.refund.timeout",
-  PAYMENT_REFUND_NOT_ALLOWED: "payment.refund.not.allowed",
-  PAYMENT_REFUND_AUTHORIZATION_FAILED: "payment.refund.authorization.failed",
-  PAYMENT_REFUND_PROCESSING_FAILED: "payment.refund.processing.failed",
+  PAYMENT_REFUND_FAILED: ERROR_CODES.PAYMENT_REFUND_FAILED,
+  PAYMENT_REFUND_NOT_FOUND: ERROR_CODES.PAYMENT_REFUND_NOT_FOUND,
+  PAYMENT_REFUND_ALREADY_PROCESSED: ERROR_CODES.PAYMENT_REFUND_ALREADY_PROCESSED,
+  PAYMENT_REFUND_AMOUNT_INVALID: ERROR_CODES.PAYMENT_REFUND_AMOUNT_INVALID,
+  PAYMENT_REFUND_VALIDATION_FAILED: ERROR_CODES.PAYMENT_REFUND_VALIDATION_FAILED,
+  PAYMENT_REFUND_TIMEOUT: ERROR_CODES.PAYMENT_REFUND_TIMEOUT,
+  PAYMENT_REFUND_NOT_ALLOWED: ERROR_CODES.PAYMENT_REFUND_NOT_ALLOWED,
+  PAYMENT_REFUND_AUTHORIZATION_FAILED: ERROR_CODES.PAYMENT_REFUND_AUTHORIZATION_FAILED,
+  PAYMENT_REFUND_PROCESSING_FAILED: ERROR_CODES.PAYMENT_REFUND_PROCESSING_FAILED,
   // Provider
-  PAYMENT_PROVIDER_ERROR: "payment.provider.error",
-  PAYMENT_PROVIDER_UNAVAILABLE: "payment.provider.unavailable",
-  PAYMENT_PROVIDER_CONFIGURATION_INVALID: "payment.provider.configuration.invalid",
-  PAYMENT_PROVIDER_RESPONSE_INVALID: "payment.provider.response.invalid",
-  PAYMENT_PROVIDER_TIMEOUT: "payment.provider.timeout",
-  PAYMENT_PROVIDER_AUTH_FAILED: "payment.provider.auth.failed",
+  PAYMENT_PROVIDER_ERROR: ERROR_CODES.PAYMENT_PROVIDER_ERROR,
+  PAYMENT_PROVIDER_UNAVAILABLE: ERROR_CODES.PAYMENT_PROVIDER_UNAVAILABLE,
+  PAYMENT_PROVIDER_CONFIGURATION_INVALID: ERROR_CODES.PAYMENT_PROVIDER_CONFIGURATION_INVALID,
+  PAYMENT_PROVIDER_RESPONSE_INVALID: ERROR_CODES.PAYMENT_PROVIDER_RESPONSE_INVALID,
+  PAYMENT_PROVIDER_TIMEOUT: ERROR_CODES.PAYMENT_PROVIDER_TIMEOUT,
+  PAYMENT_PROVIDER_AUTH_FAILED: ERROR_CODES.PAYMENT_PROVIDER_AUTH_FAILED,
+  PAYMENT_PROVIDER_RATE_LIMIT: ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT,
+  PAYMENT_PROVIDER_UNKNOWN: ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN,
+  PAYMENT_CUSTOMER_CREATION_FAILED: ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED,
+  // Payment method
+  PAYMENT_METHOD_SAVE_FAILED: ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED,
+  PAYMENT_METHOD_DELETE_FAILED: ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED,
+  // Subscription
+  PAYMENT_SUBSCRIPTION_CREATE_FAILED: ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED,
+  PAYMENT_SUBSCRIPTION_CANCEL_FAILED: ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED,
+  // Payout
+  PAYMENT_PAYOUT_FAILED: ERROR_CODES.PAYMENT_PAYOUT_FAILED,
+  // Transaction history
+  PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED: ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED,
   // Compliance
-  PAYMENT_COMPLIANCE_VIOLATION: "payment.compliance.violation",
-  PAYMENT_COMPLIANCE_CHECK_FAILED: "payment.compliance.check.failed",
-  PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: "payment.compliance.limit.exceeded",
-  PAYMENT_COMPLIANCE_POLICY_MISSING: "payment.compliance.policy.missing",
-  PAYMENT_COMPLIANCE_KYC_REQUIRED: "payment.compliance.kyc.required",
-  PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: "payment.compliance.geographic.restriction",
+  PAYMENT_COMPLIANCE_VIOLATION: ERROR_CODES.PAYMENT_COMPLIANCE_VIOLATION,
+  PAYMENT_COMPLIANCE_CHECK_FAILED: ERROR_CODES.PAYMENT_COMPLIANCE_CHECK_FAILED,
+  PAYMENT_COMPLIANCE_LIMIT_EXCEEDED: ERROR_CODES.PAYMENT_COMPLIANCE_LIMIT_EXCEEDED,
+  PAYMENT_COMPLIANCE_POLICY_MISSING: ERROR_CODES.PAYMENT_COMPLIANCE_POLICY_MISSING,
+  PAYMENT_COMPLIANCE_KYC_REQUIRED: ERROR_CODES.PAYMENT_COMPLIANCE_KYC_REQUIRED,
+  PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION: ERROR_CODES.PAYMENT_COMPLIANCE_GEOGRAPHIC_RESTRICTION,
   // Processing
-  PAYMENT_PROCESSING_FAILED: "payment.processing.failed",
-  PAYMENT_PROCESSING_TIMEOUT: "payment.processing.timeout",
-  PAYMENT_PROCESSING_GATEWAY_ERROR: "payment.processing.gateway.error",
-  PAYMENT_PROCESSING_DUPLICATE: "payment.processing.duplicate",
-  PAYMENT_PROCESSING_UNEXPECTED_STATE: "payment.processing.unexpected.state",
+  PAYMENT_PROCESSING_FAILED: ERROR_CODES.PAYMENT_PROCESSING_FAILED,
+  PAYMENT_PROCESSING_TIMEOUT: ERROR_CODES.PAYMENT_PROCESSING_TIMEOUT,
+  PAYMENT_PROCESSING_GATEWAY_ERROR: ERROR_CODES.PAYMENT_PROCESSING_GATEWAY_ERROR,
+  PAYMENT_PROCESSING_DUPLICATE: ERROR_CODES.PAYMENT_PROCESSING_DUPLICATE,
+  PAYMENT_PROCESSING_UNEXPECTED_STATE: ERROR_CODES.PAYMENT_PROCESSING_UNEXPECTED_STATE,
   // Security
-  PAYMENT_SECURITY_VIOLATION: "payment.security.violation",
-  PAYMENT_SECURITY_SIGNATURE_INVALID: "payment.security.signature.invalid",
-  PAYMENT_SECURITY_ENCRYPTION_FAILED: "payment.security.encryption.failed",
-  PAYMENT_SECURITY_FRAUD_DETECTED: "payment.security.fraud.detected",
-  PAYMENT_SECURITY_TOKEN_INVALID: "payment.security.token.invalid",
-  PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: "payment.security.velocity.limit.exceeded",
+  PAYMENT_SECURITY_VIOLATION: ERROR_CODES.PAYMENT_SECURITY_VIOLATION,
+  PAYMENT_SECURITY_SIGNATURE_INVALID: ERROR_CODES.PAYMENT_SECURITY_SIGNATURE_INVALID,
+  PAYMENT_SECURITY_ENCRYPTION_FAILED: ERROR_CODES.PAYMENT_SECURITY_ENCRYPTION_FAILED,
+  PAYMENT_SECURITY_FRAUD_DETECTED: ERROR_CODES.PAYMENT_SECURITY_FRAUD_DETECTED,
+  PAYMENT_SECURITY_TOKEN_INVALID: ERROR_CODES.PAYMENT_SECURITY_TOKEN_INVALID,
+  PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED: ERROR_CODES.PAYMENT_SECURITY_VELOCITY_LIMIT_EXCEEDED,
   // Validation
-  PAYMENT_VALIDATION_FAILED: "payment.validation.failed",
-  PAYMENT_VALIDATION_AMOUNT_INVALID: "payment.validation.amount.invalid",
-  PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: "payment.validation.currency.unsupported",
-  PAYMENT_VALIDATION_METADATA_INVALID: "payment.validation.metadata.invalid",
-  PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: "payment.validation.field.required",
+  PAYMENT_VALIDATION_FAILED: ERROR_CODES.PAYMENT_VALIDATION_FAILED,
+  PAYMENT_VALIDATION_AMOUNT_INVALID: ERROR_CODES.PAYMENT_VALIDATION_AMOUNT_INVALID,
+  PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED: ERROR_CODES.PAYMENT_VALIDATION_CURRENCY_UNSUPPORTED,
+  PAYMENT_VALIDATION_METADATA_INVALID: ERROR_CODES.PAYMENT_VALIDATION_METADATA_INVALID,
+  PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD: ERROR_CODES.PAYMENT_VALIDATION_MISSING_REQUIRED_FIELD,
   // Webhook
-  PAYMENT_WEBHOOK_SIGNATURE_INVALID: "payment.webhook.signature.invalid",
-  PAYMENT_WEBHOOK_PROCESSING_FAILED: "payment.webhook.processing.failed",
-  PAYMENT_WEBHOOK_VALIDATION_FAILED: "payment.webhook.validation.failed",
-  PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: "payment.webhook.event.type.unsupported",
-  PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: "payment.webhook.handler.not.found",
-  // ===== Payment Adapter & Core Errors =====
-  PAYMENT_ADAPTER_INIT_FAILED: "payment.adapter.init.failed",
-  PAYMENT_ADAPTER_SHUTDOWN_ERROR: "payment.adapter.shutdown.error",
-  PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: "payment.adapter.hmac.computation.failed",
-  PAYMENT_ADAPTER_MISSING_PROVIDER: "payment.adapter.missing.provider",
-  PAYMENT_ADAPTER_MISSING_ENVIRONMENT: "payment.adapter.missing.environment",
-  PAYMENT_ADAPTER_MISSING_CREDENTIALS: "payment.adapter.missing.credentials",
-  PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: "payment.adapter.missing.webhook.url",
-  PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: "payment.adapter.missing.unregister.endpoint",
-  PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: "payment.adapter.unsupported.operation",
-  PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: "payment.adapter.response.mapping.failed",
-  // Idempotency & State Management
-  PAYMENT_IDEMPOTENCY_VIOLATION: "payment.idempotency.violation",
-  PAYMENT_IDEMPOTENCY_KEY_MISSING: "payment.idempotency.key.missing",
-  PAYMENT_IDEMPOTENCY_STORE_ERROR: "payment.idempotency.store.error",
-  // Routing & Strategy
-  PAYMENT_ROUTING_FAILED: "payment.routing.failed",
-  PAYMENT_ROUTING_CONFIGURATION_INVALID: "payment.routing.configuration.invalid",
-  PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: "payment.routing.provider.unavailable",
-  PAYMENT_ROUTING_RETRY_EXCEEDED: "payment.routing.retry.exceeded",
-  // General Payment Framework Errors
-  PAYMENT_SYSTEM_NOT_INITIALIZED: "payment.system.not.initialized",
-  PAYMENT_CONTEXT_OPERATION_FAILED: "payment.context.operation.failed",
-  PAYMENT_INTERNAL_ERROR: "payment.internal.error",
-  PAYMENT_UNKNOWN_ERROR: "payment.unknown.error",
-  /**
-   * Thrown when an event could not be emitted due to internal state or creation errors.
-   * Typically non-retryable, indicates a logic or validation fault.
-   */
-  PAYMENT_EVENT_EMIT_FAILED: "PAYMENT_EVENT_EMIT_FAILED",
-  PAYMENT_EVENT_INVALID_TYPE: "PAYMENT_EVENT_INVALID_TYPE",
-  PAYMENT_EVENT_CREATION_FAILED: "PAYMENT_EVENT_CREATION_FAILED",
-  PAYMENT_EVENT_HANDLER_TIMEOUT: "PAYMENT_EVENT_HANDLER_TIMEOUT",
-  PAYMENT_EVENT_HANDLER_INVALID_RESULT: "PAYMENT_EVENT_HANDLER_INVALID_RESULT",
-  PAYMENT_EVENT_LIFECYCLE_FAILURE: "PAYMENT_EVENT_LIFECYCLE_FAILURE"
+  PAYMENT_WEBHOOK_SIGNATURE_INVALID: ERROR_CODES.PAYMENT_WEBHOOK_SIGNATURE_INVALID,
+  PAYMENT_WEBHOOK_PROCESSING_FAILED: ERROR_CODES.PAYMENT_WEBHOOK_PROCESSING_FAILED,
+  PAYMENT_WEBHOOK_VALIDATION_FAILED: ERROR_CODES.PAYMENT_WEBHOOK_VALIDATION_FAILED,
+  PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED: ERROR_CODES.PAYMENT_WEBHOOK_EVENT_TYPE_UNSUPPORTED,
+  PAYMENT_WEBHOOK_HANDLER_NOT_FOUND: ERROR_CODES.PAYMENT_WEBHOOK_HANDLER_NOT_FOUND,
+  // Adapter & Core
+  PAYMENT_ADAPTER_INIT_FAILED: ERROR_CODES.PAYMENT_ADAPTER_INIT_FAILED,
+  PAYMENT_ADAPTER_SHUTDOWN_ERROR: ERROR_CODES.PAYMENT_ADAPTER_SHUTDOWN_ERROR,
+  PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED: ERROR_CODES.PAYMENT_ADAPTER_HMAC_COMPUTATION_FAILED,
+  PAYMENT_ADAPTER_MISSING_PROVIDER: ERROR_CODES.PAYMENT_ADAPTER_MISSING_PROVIDER,
+  PAYMENT_ADAPTER_MISSING_ENVIRONMENT: ERROR_CODES.PAYMENT_ADAPTER_MISSING_ENVIRONMENT,
+  PAYMENT_ADAPTER_MISSING_CREDENTIALS: ERROR_CODES.PAYMENT_ADAPTER_MISSING_CREDENTIALS,
+  PAYMENT_ADAPTER_MISSING_WEBHOOK_URL: ERROR_CODES.PAYMENT_ADAPTER_MISSING_WEBHOOK_URL,
+  PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT: ERROR_CODES.PAYMENT_ADAPTER_MISSING_UNREGISTER_ENDPOINT,
+  PAYMENT_ADAPTER_UNSUPPORTED_OPERATION: ERROR_CODES.PAYMENT_ADAPTER_UNSUPPORTED_OPERATION,
+  PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED: ERROR_CODES.PAYMENT_ADAPTER_RESPONSE_MAPPING_FAILED,
+  // Idempotency
+  PAYMENT_IDEMPOTENCY_VIOLATION: ERROR_CODES.PAYMENT_IDEMPOTENCY_VIOLATION,
+  PAYMENT_IDEMPOTENCY_KEY_MISSING: ERROR_CODES.PAYMENT_IDEMPOTENCY_KEY_MISSING,
+  PAYMENT_IDEMPOTENCY_STORE_ERROR: ERROR_CODES.PAYMENT_IDEMPOTENCY_STORE_ERROR,
+  // Routing
+  PAYMENT_ROUTING_FAILED: ERROR_CODES.PAYMENT_ROUTING_FAILED,
+  PAYMENT_ROUTING_CONFIGURATION_INVALID: ERROR_CODES.PAYMENT_ROUTING_CONFIGURATION_INVALID,
+  PAYMENT_ROUTING_PROVIDER_UNAVAILABLE: ERROR_CODES.PAYMENT_ROUTING_PROVIDER_UNAVAILABLE,
+  PAYMENT_ROUTING_RETRY_EXCEEDED: ERROR_CODES.PAYMENT_ROUTING_RETRY_EXCEEDED,
+  // General
+  PAYMENT_SYSTEM_NOT_INITIALIZED: ERROR_CODES.PAYMENT_SYSTEM_NOT_INITIALIZED,
+  PAYMENT_CONTEXT_OPERATION_FAILED: ERROR_CODES.PAYMENT_CONTEXT_OPERATION_FAILED,
+  PAYMENT_INTERNAL_ERROR: ERROR_CODES.PAYMENT_INTERNAL_ERROR,
+  PAYMENT_UNKNOWN_ERROR: ERROR_CODES.PAYMENT_UNKNOWN_ERROR,
+  // Event
+  PAYMENT_EVENT_EMIT_FAILED: ERROR_CODES.PAYMENT_EVENT_EMIT_FAILED,
+  PAYMENT_EVENT_INVALID_TYPE: ERROR_CODES.PAYMENT_EVENT_INVALID_TYPE,
+  PAYMENT_EVENT_CREATION_FAILED: ERROR_CODES.PAYMENT_EVENT_CREATION_FAILED,
+  PAYMENT_EVENT_HANDLER_TIMEOUT: ERROR_CODES.PAYMENT_EVENT_HANDLER_TIMEOUT,
+  PAYMENT_EVENT_HANDLER_INVALID_RESULT: ERROR_CODES.PAYMENT_EVENT_HANDLER_INVALID_RESULT,
+  PAYMENT_EVENT_LIFECYCLE_FAILURE: ERROR_CODES.PAYMENT_EVENT_LIFECYCLE_FAILURE
 };
 var DATABASE_ERROR_CODES = {
   ACCESS_DENIED: ERROR_CODES.DB_ACCESS_DENIED,
@@ -3050,6 +3075,78 @@ var ERROR_DEFINITIONS = {
     userMessage: "errors.payment.processing.unexpected_state",
     severity: ERROR_SEVERITY.Critical,
     retryable: false
+  },
+  [ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT]: {
+    code: ERROR_CODES.PAYMENT_PROVIDER_RATE_LIMIT,
+    status: HTTP_STATUS.TOO_MANY_REQUESTS,
+    category: ERROR_CATEGORY.RateLimit,
+    userMessage: "errors.payment.provider.rate_limit",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN]: {
+    code: ERROR_CODES.PAYMENT_PROVIDER_UNKNOWN,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Provider,
+    userMessage: "errors.payment.provider.unknown",
+    severity: ERROR_SEVERITY.Critical,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED]: {
+    code: ERROR_CODES.PAYMENT_CUSTOMER_CREATION_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.customer.creation_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_METHOD_SAVE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.method.save_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_METHOD_DELETE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.method.delete_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED]: {
+    code: ERROR_CODES.PAYMENT_SUBSCRIPTION_CREATE_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.subscription.create_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED]: {
+    code: ERROR_CODES.PAYMENT_SUBSCRIPTION_CANCEL_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.subscription.cancel_failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_PAYOUT_FAILED]: {
+    code: ERROR_CODES.PAYMENT_PAYOUT_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.payout.failed",
+    severity: ERROR_SEVERITY.High,
+    retryable: true
+  },
+  [ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED]: {
+    code: ERROR_CODES.PAYMENT_TRANSACTION_HISTORY_FETCH_FAILED,
+    status: HTTP_STATUS.INTERNAL_SERVER_ERROR,
+    category: ERROR_CATEGORY.Processing,
+    userMessage: "errors.payment.transaction.history.fetch_failed",
+    severity: ERROR_SEVERITY.Medium,
+    retryable: true
   }
 };