Pre Requisites Setup

The following currencies are accepted by Hesabe Payment Gateway, providing comprehensive coverage across the Middle East and major international markets

Important Note

Below credentials are strictly for sandbox testing. Never use these credentials in production environment

🚀 Getting started with Hesabe Integration

Follow these essential steps to set up your Hesabe payment gateway integration:

Account Setup

Register with Hesabe and get your merchant account activated.

To activate your merchant account, please reach out to our support team:

Hesabe Merchant Support:support@hesabe.com

Hesabe Request Handler

Read more about request handler

You can follow the Hesabe Request Handler guide to get started.

Merchant Panel Access

Login to the Merchant Panel using the credentials provided after registration

Sandbox Merchant Panel

Below credentials for sandbox testing only. Never use these sandbox credentials in production environment.

FieldValue
Sandbox Username
test
Sandbox Password
Test@1234
Sandbox Merchant Panel
https://merchant.hesbstaging.com/merchant

Production Merchant Panel

To obtain the production credentials, Please Contact Hesabe Merchant Support Team using your registered email address.

FieldValue
Production UsernameContact Hesabe support team using your registered email address
Production PasswordContact Hesabe support team using your registered email address
Production Merchant Panel
https://merchant.hesbae.com/merchant
Hesabe Support Team:support@hesabe.com

API Credentials & Security Keys

Copy all credentials from merchant panel (Merchant ID, Access Code, Secret Key and IV Key) from Profile → Account section and configure them in your application.

Sandbox Access Keys

Below configuration for sandbox testing only. Never use these sandbox configurations in production environment.

Sandbox ParameterSandbox Value
Merchant Code
842217
Access Code
c333729b-d060-4b74-a49d-7686a8353481
Secret Key
PkW64zMe5NVdrlPVNnjo2Jy9nOb7v1Xg
IV Key
5NVdrlPVNnjo2Jy9

Production Access Keys

  • Copy all credentials from production merchant panel (Merchant ID, Access Code, Secret Key and IV Key) from Profile → Account section and configure them in your application.
EnvironmentMerchant Panel URL
Production
https://merchant.hesabe.com
  • Else, obtain the production keys from Hesabe merchant support team using your registered email address.
Hesabe Support Team:support@hesabe.com

Implement Payment Handlers

Create payment form and deploy request/response handlers following the integration kit guidance.

Sandbox Configuration

Below checkout API strictly for sandbox testing only. Never use these sandbox URL's in production environment

Sandbox EnvironmentSandbox URL'S
Base URL
https://sandbox.hesabe.com
Payment Initiated / Checkout URL
https://sandbox.hesabe.com/checkout
Payment Page Redirection URL
https://sandbox.hesabe.com/payment

Production Configuration

Use the following Checkout API strictly for production transactions. Ensure that you never use these production URLs in the sandbox or testing environment

Production EnvironmentProduction URL'S
Base URL
https://api.hesabe.com
Payment Initiated / Checkout URL
https://api.hesabe.com/checkout
Payment Page Redirection URL
https://api.hesabe.com/payment

Setup Return Pages

Create return pages for handling payment notifications on success or cancellation scenarios.

For technical assistance

Hesabe Technical Support:itsupport@hesabe.com

Sandbox Test Cards

These credentials are strictly for sandbox testing. Never use these credentials in production environment.

Test Cards

You can find the test card details Click here for simulating transactions in the sandbox environment