https://github.com/sslcommerz/sslcommerz-nodejs
SSLCOMMERZ is a bangladeshi payment gateway provider. This is Node module for SSLCOMMERZ.
https://github.com/sslcommerz/sslcommerz-nodejs
express-js nodejs sslcommerz
Last synced: 5 months ago
JSON representation
SSLCOMMERZ is a bangladeshi payment gateway provider. This is Node module for SSLCOMMERZ.
- Host: GitHub
- URL: https://github.com/sslcommerz/sslcommerz-nodejs
- Owner: sslcommerz
- Fork: true (ranasl62/npm-sslcommerz)
- Created: 2019-10-13T09:44:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-10-29T06:56:27.000Z (over 1 year ago)
- Last Synced: 2025-01-03T07:33:52.533Z (5 months ago)
- Topics: express-js, nodejs, sslcommerz
- Language: JavaScript
- Homepage:
- Size: 388 KB
- Stars: 93
- Watchers: 3
- Forks: 39
- Open Issues: 1
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# [SSLCommerz - Node.js Library](https://www.npmjs.com/package/sslcommerz-lts)
LTS package, Officially supported by SSLCommerz Integration Team.
## Installation
```bash
npm i sslcommerz-lts
```
## How to use:
### Initialize a Transaction
```js
const express = require('express')
const app = express()
const SSLCommerzPayment = require('sslcommerz-lts')
const store_id = ''
const store_passwd = ''
const is_live = false //true for live, false for sandbox
const port = 3030
//sslcommerz init
app.get('/init', (req, res) => {
const data = {
total_amount: 100,
currency: 'BDT',
tran_id: 'REF123', // use unique tran_id for each api call
success_url: 'http://localhost:3030/success',
fail_url: 'http://localhost:3030/fail',
cancel_url: 'http://localhost:3030/cancel',
ipn_url: 'http://localhost:3030/ipn',
shipping_method: 'Courier',
product_name: 'Computer.',
product_category: 'Electronic',
product_profile: 'general',
cus_name: 'Customer Name',
cus_email: '[email protected]',
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',
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.init(data).then(apiResponse => {
// Redirect the user to payment gateway
let GatewayPageURL = apiResponse.GatewayPageURL
res.redirect(GatewayPageURL)
console.log('Redirecting to: ', GatewayPageURL)
});
})
app.listen(port, () => {
console.log(`Example app listening at http://localhost:${port}`)
})
```
### Validate after successful transaction (inside success and ipn controller methods)
```js
//sslcommerz validation
app.get('/validate', (req, res) => {
const data = {
val_id:ADGAHHGDAKJ456454 //that you go from sslcommerz response
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.validate(data).then(data => {
//process the response that got from sslcommerz
// https://developer.sslcommerz.com/doc/v4/#order-validation-api
});
})
```
### To initiate a refund through API
```js
//SSLCommerz initiateRefund
app.get('/initiate-refund', (req, res) => {
const data = {
refund_amount:10,
refund_remarks:'',
bank_tran_id:CB5464321445456456,
refe_id:EASY5645415455,
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.initiateRefund(data).then(data => {
//process the response that got from sslcommerz
//https://developer.sslcommerz.com/doc/v4/#initiate-the-refund
});
})
```
### Query the status of a refund request
```js
//SSLCommerz refundQuery
app.get('/refund-query', (req, res) => {
const data = {
refund_ref_id:SL4561445410,
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.refundQuery(data).then(data => {
//process the response that got from sslcommerz
//https://developer.sslcommerz.com/doc/v4/#initiate-the-refund
});
})
```
### Query the status of a transaction (by Transaction ID)
```js
//SSLCommerz transactionQueryByTransactionId
//you also use this as internal method
app.get('/transaction-query-by-transaction-id', (req, res) => {
const data = {
tran_id:AKHLAKJS5456454,
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.transactionQueryByTransactionId(data).then(data => {
//process the response that got from sslcommerz
//https://developer.sslcommerz.com/doc/v4/#by-session-id
});
})
```
### Query the status of a transaction (by session ID)
```js
//SSLCommerz transactionQueryBySessionId
//you also use this as internal method
app.get('/transaction-query-by-session-id', (req, res) => {
const data = {
sessionkey:AKHLAKJS5456454,
};
const sslcz = new SSLCommerzPayment(store_id, store_passwd, is_live)
sslcz.transactionQueryBySessionId(data).then(data => {
//process the response that got from sslcommerz
//https://developer.sslcommerz.com/doc/v4/#by-session-id
});
})
```
- Find more details in [SSLCommerz Developer's Guide](https://developer.sslcommerz.com/)
- For any technical queries: [email protected]
© 2019-2021 SSLCOMMERZ ALL RIGHTS RESERVED