Helpers & Constants

The SDK ships with bank constants, enums and utility functions so you can look up information quickly without calling the API.

---

Bank Constants

Look up the BIN, short name and full name of the banks supported by Tingee.

Node.js

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

// Look up by BIN
getBankCode('970436')       // BankNameEnum.VCB
getBankShortName('970436')  // 'Vietcombank'

// Look up by name
getBankBin(BankNameEnum.VIETCOMBANK) // '970436'

// List all banks
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

Bank short codes, used in bank-related APIs.

Value	Bank
OCB	Orient Commercial Joint Stock Bank
BIDV	Joint Stock Commercial Bank for Investment and Development of Vietnam
MBB	Military Commercial Joint Stock Bank
ACB	Asia Commercial Joint Stock Bank
VPB	Vietnam Prosperity Joint Stock Commercial Bank
PGB	Prosperity and Growth Commercial Joint Stock Bank
VIB	Vietnam International Commercial Joint Stock Bank
STB	Saigon Thuong Tin Commercial Joint Stock Bank
CTG	Vietnam Joint Stock Commercial Bank for Industry and Trade
VCB	Joint Stock Commercial Bank for Foreign Trade of Vietnam
AGRIBANK	Vietnam Bank for Agriculture and Rural Development
SHINHAN	Shinhan Bank Vietnam Limited
COB	Co-operative Bank of Vietnam

BankBinEnum

The BIN (Bank Identification Number) of each bank.

Value	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

Account type used when creating a virtual account.

Value	Description
personal-account	Personal account
business-account	Business account
business-household-account	Household business account

---

Response Helpers

Node.js

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

// Check for a successful response (code === '00')
if (isSuccessResponse(result)) { /* ... */ }

// Check for an error response (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

The SDK also exports the signature functions in case you need them separately (rarely needed, since the SDK handles signing for you):

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);