Skip to main content

HNCB - Hua Nan Commercial Bank

This page provides an overview of the payments methods provided by the HNCB - Hua Nan Commercial Bank adapter in the IXOPAY platform. It also includes a full list of all configuration options available to you when integrating HNCB - Hua Nan Commercial Bank within your payments landscape, as well as an overview of the parameters required when submitting a transaction via IXOPAY's API.

Payment Methods

Payment MethodTransaction FlowsTransaction Types
Bank TransferFull Page RedirectDebit
Credit CardFull Page RedirectDebit
HNCB QRFull Page RedirectDebit

Connector Config

Parameter / NameTypeRequiredAllowed ValueDescription
MerchantID_CreditCardStringtrue-Provided by HNCB. Also referred to as "StoreID"
TerminalID_CreditCardStringtrue-Provided by HNCB.
MerID_CreditCardStringtrue-Provided by HNCB
CheckID_CreditCardStringtrue-Provided by HNCB.
MerchantName_CreditCardStringtrue-The Merchant Name that gets displayed during the Checkout Process.
MerchantID_QRStringtrue-Provided by HNCB.
TerminalID_QRStringtrue-Provided by HNCB.
AcquiringBank_QRStringtrue3 charsProvided by HNCB.
MerchantName_QRStringtrue-The Merchant Name that is being used to generate the QR Code.
SecureCode_QRStringtrue-Provided by HNCB.
VerificationParameter_QRStringtrue32 chars32 char Hexadecimal String - shared between Merchant and HNCB, required for the QR Encryption.
DefaultCountryCode_QRStringtrue3 charsRequired for the QR Code generation - usually consists of three numbers.
EnterpriseCode_BankTransfer_QRStringtrue5 charsProvided by HNCB. Also referred to as "Virtual Account"
EBillMerchantNumber_BankTransferStringtrue-Provided by HNCB.
PaymentTypeNumber_BankTransferStringtrue-Provided by HNCB.
FeeTypeNumber_BankTransferStringtrue-Provided by HNCB.

Important Information (HNCB QR + Bank Transfer)

HNCB requires a strict format for the OrderNumber (also known as NoticeNumber in case of the Bank Transfer Payment Method) that is sent to them. The structure of this Number looks like : 5 chars (EnterpriseCode_BankTransfer_QR is automatically taken from the Connector Config) + 11 chars.

Our Gateway requires you to set up a Terminal to your Connector, which will autogenerate a STAN and add it as part of the OrderNumber.