SSLCommerz Module

18 views Markdown

Connect SSLCommerz to accept payments through its hosted page or popup and follow the resulting invoices in WISECP.

Reaching the Screen

Go to Settings → Financial → Payment Gateways → All Modules and click SSLCommerz: {admin}/modules/payment?module=SSLCommerz

What Is on the Screen

The form contains store credentials, a test switch, a popup choice and shared gateway settings. With easyCheckout off, clients continue to SSLCommerz's hosted page. Enabled opens its popup.

The module offers no WISECP card storage, automatic payments, subscriptions or installment settings. The provider's available payment channels depend on your merchant account. Refund support differs between single-invoice and combined payments; see the refund task.

Before You Configure It

Obtain separate sandbox and live Store ID/password pairs from SSLCommerz. Use an approved merchant account for live payments, HTTPS and a server supporting TLS 1.2 or newer.

Confirm your store's currency and transaction limits with SSLCommerz. Non-BDT payments can be converted to BDT by the provider. For API refunds, have SSLCommerz register your server's public outbound IP.

Use a separate test system. There is no connection-test button, so saved credentials still need a test payment.

Fields

Store IDRequired; empty by default. Use the store for the selected test or live environment.
Store PasswordRequired; empty by default. Enter the integration password supplied for that Store ID, not your merchant-panel login password.
Test ModeOff by default. Enabled uses the sandbox; disabled uses the live service. Replace the credentials when switching.
easyCheckoutOff by default. Enabled selects the popup; disabled selects the hosted payment page.

Status enables the module. Commission, conversion, amount limits and country lists are explained in Payment Modules. Callback URL, Success URL and Failed URL are generated addresses.

Tasks

Configure the Store

  1. Use SSLCommerz sandbox registration for testing. Obtain the store's integration credentials; live credentials come from your approved merchant account.
  2. In the WISECP SSLCommerz form, enable Status, enter Store ID and Store Password, and enable Test Mode.
  3. Choose easyCheckout or leave it off for the hosted page. Click Save Changes.
  4. In Payment Gateways → Initial → Enabled Module Selection, select SSLCommerz and click Save Changes. The method becomes available within its configured limits.

Configure Payment Notifications

  1. Copy Callback URL from the WISECP form and append ?callback_type=ipn.
  2. In the SSLCommerz merchant panel, open My Store → IPN Settings. Register that complete address as the IPN listener and save the store's notification settings.
  3. Use the corresponding store in each environment. The module also sends this IPN address with payment creation; no separate webhook-signing-secret field is needed.
  4. Check that SSLCommerz can deliver a notification and that WISECP validates and records it. A browser visit to Success URL does not confirm payment.

Test and Switch to Live

  1. Open an unpaid test invoice as its client. Select SSLCommerz and click Pay Now.
  2. Complete the hosted page or popup using SSLCommerz sandbox payment details. Test both display choices if you plan to offer both.
  3. Compare the provider transaction, amount and currency with the paid invoice. Check cancellation and notification delivery after an interrupted browser return.
  4. Enter the live store pair, clear Test Mode and click Save Changes. Subsequent payments use real funds; verify the live store's IPN setting too.

Refund a Payment

For a payment covering one invoice, use the SSLCommerz merchant panel. The current module's single-payment refund path does not call SSLCommerz's refund service.

  1. In SSLCommerz, open the transaction details and Refund Request. Enter the full or partial amount, submit the request and check its status.
  2. For a full refund, open the WISECP invoice: {admin}/invoices/detail?id={invoice}.
  3. Under Summary → Change Status, select Refunded and Add as expense, then click Update Status.
  4. WISECP records the refund without sending money again. Record a partial refund separately for its actual amount.

For a payment covering several invoices, the module has a separate API refund path for each invoice's collected share. From that invoice's same status controls, choose Refund via payment gateway and click Update Status. This requires store credentials and a bank transaction reference; the module can query older references. Check the final refund in SSLCommerz even when WISECP accepts the request.

Things to Watch

Re-enter the Store Password Before Saving

In the current version, the password control can be filled from Store ID when the form reopens. Replace it with the real integration password before saving any changes.

Check the Payment, Not the Return Page

A successful return alone cannot close the invoice. Failed validation, a different amount or a risk flag can leave it unpaid. Compare the provider transaction before requesting another payment.

A Refund Request Is Not a Completed Refund

An accepted or processing API response can update WISECP before the customer receives funds. Follow completion in SSLCommerz and avoid submitting the same refund through both systems.

Required Privileges

WISECP settings require Modules → Payment Gateways (MODULES_PAYMENT_SETTINGS). Invoice changes require Billing → Edit (INVOICES_OPERATION). SSLCommerz access must cover store/IPN settings and refund requests; ask the merchant administrator for those permissions.

Was this helpful?

Thanks for your feedback!

Still Need Help?

Our support team is here around the clock for anything you can't find above.

Contact Us Open a Ticket

We use cookies to keep you signed in, remember your language and currency, and improve the site. Cookie Policy