Class: NganLuong

NganLuong(config)

NganLuong payment gateway helper
Hàm hỗ trợ thanh toán qua Ngân Lượng

Constructor

new NganLuong(config)

Instantiate a NganLuong checkout helper
Khởi tạo hàm thanh toán NganLuong

Parameters:
Name Type Description
config Object

check NganLuong.configSchema for data type requirements
Xem NganLuong.configSchema để biết yêu cầu kiểu dữ liệu
Source:
Example
import { NganLuong } from 'vn-payments';

const TEST_CONFIG = NganLuong.TEST_CONFIG;

const nganluongCheckout = new NganLuong({
	paymentGateway: TEST_CONFIG.paymentGateway,
	merchant: TEST_CONFIG.merchant,
 receiverEmail: TEST_CONFIG.receiverEmail,
	secureSecret: TEST_CONFIG.secureSecret,
});

// checkoutUrl is an URL instance
const checkoutUrl = await nganluongCheckout.buildCheckoutUrl(params);

this.response.writeHead(301, { Location: checkoutUrl.href });
this.response.end();

Members

(static) checkoutSchema :SimpleSchema

The schema is based on field data requirements from NganLuong's dev document
Cấu trúc dữ liệu được dựa trên các yêu cầu của tài liệu Ngân Lượng

Type:
  • SimpleSchema
Source:

(static) TEST_CONFIG

NganLuong test configs
Cấu hình dùng thử Ngân Lượng

Source:

checkoutPayloadDefaults

Return default checkout Payloads

Lấy checkout payload mặc định cho cổng thanh toán này

Source:

Methods

(static) getReturnUrlStatus(responseCode, locale) → {string}

Get known response code status
Lấy chuỗi trạng thái từ response code đã biết

Parameters:
Name Type Default Description
responseCode string

Response code from gateway
Mã trả về từ cổng thanh toán
locale string vn

Same locale at the buildCheckoutUrl. Note, 'vn' for Vietnamese
Cùng nơi với hàm buildCheckoutUrl. Lưu ý, 'vn' là Việt Nam
Source:
Returns:

A string contains error status converted from response code
Một chuỗi chứa trạng thái lỗi được chuyển lại từ response code

Type
string

buildCheckoutUrl(payload) → {Promise.<URL>}

Build checkoutUrl to redirect to the payment gateway
Hàm xây dựng url để redirect qua NganLuong gateway, trong đó có tham số mã hóa (còn gọi là public key)

Parameters:
Name Type Description
payload NganLuongCheckoutPayload

Object that contains needed data for the URL builder, refer to typeCheck object above
Đối tượng chứa các dữ liệu cần thiết để thiết lập đường dẫn.
Source:
Returns:

buildCheckoutUrl promise

Type
Promise.<URL>

validateCheckoutPayload(payload)

Validate checkout payload against specific schema. Throw ValidationErrors if invalid against checkoutSchema
Kiểm tra tính hợp lệ của dữ liệu thanh toán dựa trên một cấu trúc dữ liệu cụ thể. Hiển thị lỗi nếu không hợp lệ với checkoutSchema.

Parameters:
Name Type Description
payload NganLuongCheckoutPayload
Source:

verifyReturnUrl(query) → {Promise.<NganLuongReturnObject>}

Verify return query string from NganLuong using enclosed vnp_SecureHash string
Hàm thực hiện xác minh tính đúng đắn của các tham số trả về từ nganluong Payment

Parameters:
Name Type Description
query Object

Query data object from GET handler (response.query)
Dữ liệu được trả về từ GET handler (response.query)
Source:
Returns:

Promise object which resolved with normalized returned data object, with additional fields like isSuccess.
Promise khi hoàn thành sẽ trả về object data từ cổng thanh toán, được chuẩn hóa tên theo camelCase và đính kèm thuộc tính isSuccess

Type
Promise.<NganLuongReturnObject>