Hàm hỗ trợ & Constants

SDK cung cấp sẵn các hằng số ngân hàng, enum và hàm tiện ích để tra cứu nhanh thông tin mà không cần gọi API.

---

Bank Constants

Tra cứu mã BIN, tên viết tắt và tên đầy đủ của các ngân hàng được Tingee hỗ trợ.

Node.js

import {
  BankNameEnum, BankBinEnum, BankAccountTypeEnum,
  getBankCode, getBankShortName, getBankBin, Banks
} from '@tingee/sdk-node';

// Tra cứu theo BIN
getBankCode('970436')       // BankNameEnum.VCB
getBankShortName('970436')  // 'Vietcombank'

// Tra cứu theo tên
getBankBin(BankNameEnum.VIETCOMBANK) // '970436'

// Danh sách tất cả ngân hàng
Banks.forEach(b => console.log(`${b.shortName}: ${b.bin}`));

Java

import vn.tingee.sdk.constants.BankConstants;
import vn.tingee.sdk.constants.BankConstants.BankNameEnum;

BankConstants.getBin(BankNameEnum.VIETCOMBANK)       // "970436"
BankConstants.getShortName(BankNameEnum.VIETCOMBANK) // "Vietcombank"
BankConstants.getFullName(BankNameEnum.VIETCOMBANK)  // "Ngân hàng TMCP Ngoại Thương Việt Nam"

C#

using Tingee.Sdk.Types;

BankConstants.GetBin(BankNameEnum.VIETCOMBANK)       // "970436"
BankConstants.GetShortName(BankNameEnum.VIETCOMBANK) // "Vietcombank"
BankConstants.GetFullName(BankNameEnum.VIETCOMBANK)  // "Ngân hàng TMCP Ngoại Thương Việt Nam"

PHP

use Tingee\Sdk\Types\BankNameEnum;
use Tingee\Sdk\Types\BankConstants;

BankConstants::getBin(BankNameEnum::VIETCOMBANK)       // "970436"
BankConstants::getShortName(BankNameEnum::VIETCOMBANK) // "Vietcombank"
BankConstants::getFullName(BankNameEnum::VIETCOMBANK)  // "Ngân hàng TMCP Ngoại Thương Việt Nam"

---

Enums

BankNameEnum

Mã viết tắt của ngân hàng, dùng cho các API liên quan đến ngân hàng.

Giá trị	Ngân hàng
OCB	Ngân hàng TMCP Phương Đông
BIDV	Ngân hàng TMCP Đầu tư và Phát triển Việt Nam
MBB	Ngân hàng TMCP Quân đội
ACB	Ngân hàng TMCP Á Châu
VPB	Ngân hàng TMCP Việt Nam Thịnh Vượng
PGB	Ngân Hàng TMCP Thịnh vượng và Phát triển
VIB	Ngân hàng TMCP Quốc tế Việt Nam
STB	Ngân hàng TMCP Sài Gòn Thương Tín
CTG	Ngân hàng TMCP Công thương Việt Nam
VCB	Ngân hàng TMCP Ngoại Thương Việt Nam
AGRIBANK	Ngân hàng Nông nghiệp và Phát triển Nông thôn
SHINHAN	Ngân hàng TNHH MTV Shinhan Việt Nam
COB	Ngân hàng Hợp tác Xã Việt Nam

BankBinEnum

Mã BIN (Bank Identification Number) tương ứng với từng ngân hàng.

Giá trị	BIN
OCB	970448
BIDV	970418
MBB	970422
ACB	970416
VPB	970432
PGB	970430
VIB	970441
STB	970403
CTG	970415
VCB	970436
AGRIBANK	970405
SHINHAN	970424
COB	970446

BankAccountTypeEnum

Loại tài khoản dùng khi tạo Virtual Account.

Giá trị	Mô tả
personal-account	Tài khoản cá nhân
business-account	Tài khoản doanh nghiệp
business-household-account	Tài khoản hộ kinh doanh

---

Response Helpers

Node.js

import { isSuccessResponse, isErrorResponse } from '@tingee/sdk-node';

// Kiểm tra response thành công (code === '00')
if (isSuccessResponse(result)) { /* ... */ }

// Kiểm tra response lỗi (code !== '00')
if (isErrorResponse(result)) { /* ... */ }

Java

// result.isSuccess() → code == "00"
// result.isError()   → code != "00"
if (result.isSuccess()) { /* ... */ }

C#

// result.IsSuccess → Code == "00"
if (result.IsSuccess) { /* ... */ }

PHP

// $result->isSuccess() → code === '00'
// $result->isError()   → code !== '00'
if ($result->isSuccess()) { /* ... */ }

---

Signature Helpers

SDK cũng export các hàm tạo chữ ký nếu cần dùng riêng (ít khi cần vì SDK tự xử lý):

Node.js

import { generateSignature, formatTimestamp } from '@tingee/sdk-node';

const timestamp = formatTimestamp(new Date());
const signature = generateSignature('your-secret-key', timestamp, body);

Java

import vn.tingee.sdk.signature.TingeeSigner;

String signature = TingeeSigner.generateSignature(secretKey, timestamp, bodyJson);

C#

using Tingee.Sdk.Signature;

var signature = TingeeSigner.GenerateSignature(secretKey, timestamp, bodyJson);

PHP

use Tingee\Sdk\Signature\TingeeSigner;

$signature = TingeeSigner::generateSignature($secretKey, $timestamp, $bodyJson);