BizKitHub Developer Documentation

Parameters

1 query · JSON body

Query parameters

· 1

apiKeystringRequired

Your BizKitHub API key (passed as GET parameter).

Key format: A 32-character string matching: ^(PROD|DEV_|ROOT)[A-Za-z0-9]{28}$
Prefixes: PROD (production key), DEV_ (individual developer), ROOT (system key with no limits). Learn more

ExamplePRODPGrFxpGEtrOZfuWhnoJohUYBXuOE

Request body

application/json

cuRefNostringRequired

cuRefNo = customer reference number.

Length: 16–16

Example1cGIHvFoQDGLAbcA

bankAccountstringRequired

Digits-only technical formats (Czech accounts only):
- 20 digits BBAN: BBBBPPPPPPAAAAAAAAAA (bank 4 + prefix 6 + account 10).
- 22 digits: CCBBBB... where it represents CZ + check digits + BBAN without the country prefix.
- Without separators: <account+optional prefix><bank>, e.g. 20027706302010.

Invalid input: If the value contains letters but is not a valid/repairable IBAN, conversion fails and the endpoint returns { success: false }.

ExamplesCZ54201000000020027706302002770630/2010000000-2002770630/201020027706302010

currencystringOptional

Currency code. Format: 3-letter uppercase code (e.g. CZK).
Supported values: CZK, EUR, USD.

ExamplesCZKEURUSD

Response schema

1 status code documented

200Success

successbooleanRequired

Response example

application/json

{
  "success": false
}

curl -X POST "https://api.bizkithub.com/api/v1/customer/add-bank-account?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer YOUR_API_KEY" \ -d '{ "cuRefNo": "1cGIHvFoQDGLAbcA", "bankAccount": "CZ5420100000002002770630", "currency": "CZK" }'

/api/v1/customer/add-bank-account