sslcommerz-js

@siamf/sslcommerz

A well-maintained, unofficial Node.js package for integrating SSLCommerz payments. Provides reliable support for initiating and handling transactions with minimal setup.

This is 100% secure and build with official docs. It doesn't contain any unwanted activity code and the full code is open source.

Note: @siamf/sslcommerz, sslcommerz-js, sslcommerz-nodesdk all published from a single codebase, so you can use any of this 3 package

Installation

npm i @siamf/sslcommerz
pnpm i @siamf/sslcommerz
yarn add @siamf/sslcommerz

Usage

Initialize Package

import { SslCommerz } from "@siamf/sslcommerz";

const store_id = "<store_id>"
const store_passwd = "<store_password>"
const is_live = false;
export const sslcz = new SslCommerz(store_id, store_passwd, is_live);

Init the payment

const data = {
    total_amount: 100,
    currency: 'EUR',
    tran_id: 'REF123',
    success_url: 'http://yoursite.com/success',
    fail_url: 'http://yoursite.com/fail',
    cancel_url: 'http://yoursite.com/cancel',
    ipn_url: 'http://yoursite.com/ipn',
    shipping_method: 'Courier',
    product_name: 'Computer.',
    product_category: 'Electronic',
    product_profile: 'general',
    cus_name: 'Customer Name',
    cus_email: '[e-mail]',
    cus_add1: 'Dhaka',
    cus_add2: 'Dhaka',
    cus_city: 'Dhaka',
    cus_state: 'Dhaka',
    cus_postcode: '1000',
    cus_country: 'Bangladesh',
    cus_phone: '01711111111',
    cus_fax: '01711111111',
    ship_name: 'Customer Name',
    ship_add1: 'Dhaka',
    ship_add2: 'Dhaka',
    ship_city: 'Dhaka',
    ship_state: 'Dhaka',
    ship_postcode: 1000,
    ship_country: 'Bangladesh',
    multi_card_name: 'mastercard',
    value_a: 'ref001_A',
    value_b: 'ref002_B',
    value_c: 'ref003_C',
    value_d: 'ref004_D'
};

const sslResponse = await sslcz.init(data);

Validate the payment

const data = {
    val_id:ADGAHHGDAKJ456454 //that you go from sslcommerz response
};

const sslResponse = await sslcz.validate(data)

Initiate Refund

const data = {
    refund_amount:10,
    refund_remarks: "",
    bank_tran_id: "CB5464321445456456",
    refe_id: "EASY5645415455"
};

const sslResponse = await sslcz.initiateRefund(data)

Query the refund

const data = {
    refund_ref_id: "SL4561445410"
};

const sslResponse = await sslcz.refundQuery(data)

Query transaction by session ID

const data = {
    sessionkey: "AKHLAKJS5456454"
};

const sslResponse = await sslcz.transactionQueryBySessionId(data);

Query transaction by transaction ID

const data = {
    tran_id: "AKHLAKJS5456454"
};

const sslResponse = await sslcz.transactionQueryByTransactionId(data);

Suggestions, improvements, and pull requests are always welcome.

Stay in touch

• Author - Siam Ahnaf
• Website - https://www.siamahnaf.com/
• LinkedIn - https://www.linkedin.com/in/siamahnaf/
• Github - https://github.com/siamahnaf