BizKitHub
DocsInteractive API Docs/api/v1/customer/add-bank-account
post

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

API endpoint documentation

Endpoint Info
Base URLapi.bizkithub.com
AuthBearer Token
Methods1
Authentication Required

This endpoint requires a valid API key passed as a query parameter or Bearer token.

Get your API key

Parameters

1 query, 3 body parameters

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

cuRefNostringrequired

cuRefNo = customer reference number.

Length: 16 - 16
bankAccountstringrequired

Bank account identifier to be validated / converted to IBAN.

Supported formats:

  • IBAN (ISO 7064 MOD-97-10), e.g. CZ5420100000002002770630.

    • Spaces and separators are allowed; they will be removed.
    • Letters are uppercased automatically.
    • For CZ IBANs with incorrect check digits, the checksum may be repaired (recomputed from BBAN).

  • Czech domestic format (national account), e.g. 2002770630/2010.

    • Optional prefix is supported: 000000-2002770630/2010.
    • The bank code must be 4 digits.
    • Prefix max 6 digits, account number max 10 digits.

  • 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 }.

currencystring

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

Example Request

JavaScript fetch

const response = await fetch("https://api.bizkithub.com/api/v1/customer/add-bank-account?apiKey=PRODPGrFxpGEtrOZfuWhnoJohUYBXuOE", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "cuRefNo": "1cGIHvFoQDGLAbcA",
    "bankAccount": "CZ5420100000002002770630",
    "currency": "CZK"
  })
});

const data = await response.json();
console.log(data);
post

Example Response

200Success
{
  "success": false
}

cURL

Command line example

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

Need an API key?

All BizKitHub API endpoints require authentication via API key.

Get API Key
Back to API DocumentationAPI Reference