# SSLCommerz

> Set up SSLCommerz on your own merchant account in Bangladesh: enter the store ID and store password, set the IPN URL, and see how hotspot payments complete.

Source: https://docs.centipidbilling.com/billing/payment-gateways/sslcommerz

## Collect payments with SSLCommerz

`SSLCOMMERZ` sends the payer to **SSLCommerz's own payment page**, where they pay
by card, mobile wallet or net banking.

When the payer comes back, and again when SSLCommerz sends its IPN (instant
payment notification), Centipid Billing asks SSLCommerz whether the payment is
valid. The package is credited only when SSLCommerz says the payment is `VALID`
or `VALIDATED`, in BDT, for at least the package price. Nothing in the browser
return or the IPN body is trusted on its own, and a payment that arrives by
both routes credits the package once.

The money goes into **your own SSLCommerz merchant account**. Centipid Billing
never holds it.

Offered in the country catalog for Bangladesh only. Your billing currency must
be `BDT`, or payments are refused before they reach SSLCommerz.

## Configure the gateway

#### Get your store ID and password from SSLCommerz

In the SSLCommerz merchant panel, open your store's API credentials and copy
the **Store ID** and **Store Password**. Use your live store's credentials:
sandbox credentials are not accepted.

#### Open Settings → Payments → SSLCommerz

Select SSLCommerz from the payment marketplace.

#### Enter the credentials

Paste the store ID and store password, then switch to SSLCommerz. Keep
the password private.

#### Set the IPN URL in SSLCommerz

In the merchant panel, open the IPN settings and paste the **IPN URL** shown
on the gateway page in Billing.

## Callback URLs

| Where | URL |
| --- | --- |
| SSLCommerz merchant panel, IPN listener | `https://<your portal domain>/api/sslcommerz/ipn` |

The success, fail and cancel return address
(`/api/sslcommerz/return/<payment reference>`) is sent with each payment, so
there is nothing to register for it.
