Halyk Bank payment gateway

Write a review
Accept Bank Cards payments in your CS-Cart store via Halyk Bank. Secure redirect-based checkout for merchants in Kazakhstan.
$99.00
Request Customization

CartModules: Halyk Bank Payment Gateway

Accept payments from customers in Kazakhstan through Halyk Bank, the country's largest and most trusted bank. This addon integrates the Halyk Bank e-commerce payment gateway with your CS-Cart store using the modern REST API with OAuth2 authentication.

No card data touches your server. Customers are redirected to Halyk Bank's secure hosted payment page for card entry and 3D Secure verification, keeping your store PCI SAQ A compliant.

Key Features

OAuth2 Authentication

Secure bearer token authentication using client credentials grant. Tokens are obtained per-transaction for maximum security.

3D Secure Support

Full 3DS verification handled natively on the Halyk Bank payment page, reducing fraud and chargebacks.

Server-to-Server Callbacks

Reliable order status updates via server notification URL, ensuring orders are processed even if the customer closes their browser.

Signature Verification

SHA-256 signature verification on all callbacks prevents unauthorized status changes and payment tampering.

Sandbox Mode

Test your integration risk-free using the Halyk Bank sandbox environment before going live.

Custom Status Mapping

Map Halyk Bank payment statuses (approved, declined, pending) to any CS-Cart order status of your choice.

How It Works

1 Customer selects Halyk Bank at checkout and clicks "Place order" 2 The addon authenticates with Halyk Bank and creates a payment session 3 Customer is redirected to the Halyk Bank secure payment page 4 Customer enters card details and completes 3D Secure verification 5 Customer is redirected back to your store with the payment result 6 The addon verifies the signature, confirms the payment status, and updates the order

Configuration

Setting Description
Payment Mode Toggle between Test (Sandbox) and Live (Production) environments
Merchant ID (Terminal ID) Your Terminal ID provided by Halyk Bank
Secret Key Shared secret key for OAuth2 authentication and callback signature verification
Status: Approved CS-Cart order status when payment is authorized or charged (default: Processed)
Status: Declined CS-Cart order status when payment is rejected (default: Failed)
Status: Pending CS-Cart order status when payment is pending (default: Open)

Security

  • SSL/TLS verification enforced on all API communications
  • No card data stored or transmitted through your server (PCI SAQ A)
  • SHA-256 callback signature verification prevents tampering
  • OAuth2 bearer tokens used for API authentication
  • Sensitive data (API keys, tokens, secrets) stripped from all logs
  • Idempotent callback handling prevents duplicate order processing
  • All input parameters type-cast and sanitized
  • Parameterized database queries prevent SQL injection

Requirements

CS-Cart Version 4.x (Ultimate or Multi-Vendor)
PHP Version 7.1 or higher
SSL Certificate Required (for callback URLs)
Halyk Bank Account E-commerce merchant account with API credentials
Currency KZT (Kazakhstani Tenge)

Installation

  1. Go to Add-ons > Manage add-ons, click Manual installation, and upload the addon zip
  2. Activate the addon and enter the license key
  3. Navigate to Administration > Payment methods and add a new payment method
  4. Select "Halyk Bank Payment Gateway" as the processor
  5. Enter your Merchant ID and Secret Key
  6. Save and start accepting payments
Billing Type:
Lifetime
Compatible versions:
  • 4.10.1
  • 4.10.2
  • 4.10.3
  • 4.10.4
  • 4.10.4.SP1
  • 4.11.1
  • 4.11.2
  • 4.11.3
  • 4.11.4
  • 4.11.5
  • 4.12.1
  • 4.12.2
  • 4.13.1
  • 4.13.2
  • 4.13.2.SP1
  • 4.13.2.SP2
  • 4.13.3
  • 4.14.1
  • 4.14.1.SP1
  • 4.14.2
  • 4.14.2.SP1
  • 4.14.3
  • 4.14.3.SP1
  • 4.15.1
  • 4.15.1.SP1
  • 4.15.1.SP2
  • 4.15.1.SP3
  • 4.15.1.SP4
  • 4.15.2
  • 4.16.1
  • 4.16.2
  • 4.17.1
  • 4.17.2
  • 4.17.2.SP1
  • 4.17.2.SP2
  • 4.17.2.SP3
  • 4.18.1
  • 4.6.3
  • 4.7.1
  • 4.7.2
  • 4.7.3
  • 4.7.4
  • 4.8.1
  • 4.8.2
  • 4.9.1
  • 4.9.2
  • 4.9.3
Localizations:
  • English
Payment type:
One-time payment
Product:
  • Multi-Vendor
  • Multi-Vendor Plus
  • Multi-Vendor Ultimate
  • Store Builder
  • Store Builder Plus
  • Store Builder Ultimate

Addons features

Development:
  • Backend
  • Frontend
Recipient:
  • For customer
  • For owner
  • For vendor
Server Update:

Shared features

External ID:
Cartmodules-Almapay
License number prefix:
CARTMODULES
On market:

No reviews found

FAQ Block


Related Products