Import Single Transfer

The Import Single Transfer service is used to create one or more single transfer orders in the bank's system.

The service supports submitting up to 10 individual transfer orders within a single request.

Orders are sent in the singleTransferOrders array. The type of each order is defined by the transferType field.

If one or more transfer orders fail validation, the entire request will not be rejected. Only the invalid transfer orders will be rejected, while all valid transfer orders will continue to be processed.

Endpoint

POST /bab/v1/transfers/single

Request Parameters

Field	Type	Required	Description
singleTransferOrders	array/ SingleTransferOrder	✅	List of transfer orders The array must not be empty Maximum quantity - 10 orders

SingleTransferOrder object

Field	Type	Required	Description
transferType	string	✅	Transfer type
transferExternalId	integer	❌	External transfer ID assigned by the client system.
documentNumber	integer	❌	Document number
position	integer	❌	Order position in the request
debitAccount	object / AccountIdentification	✅	Debit account
creditAccount	objectt / AccountIdentification	Depends on type	Beneficiary account Not used for TreasuryTransfer
amount	object / Money	✅	Transfer amount and currency
description	string	Depends on type	Transfer purpose
additionalDescription	string	❌	Additional description
beneficiaryName	string	Depends on type	Beneficiary name
beneficiaryTaxCode	string	❌	Beneficiary identification / tax code
beneficiaryAddress	string	Depends on type	Beneficiary address for a foreign currency transfer to another bank
beneficiaryBankCode	string	Depends on type	Beneficiary bank code
beneficiaryBankName	string	❌	Beneficiary bank name
intermediaryBankCode	string	❌	Intermediary bank code
intermediaryBankName	string	❌	Intermediary bank name
chargeDetails	string	Depends on type	Charge details for a foreign currency transfer to another bank
taxpayerCode	string	Depends on type	Taxpayer code for a treasury transfer
taxpayerName	string	Depends on type	Taxpayer name for a treasury transfer
treasuryCode	string	Depends on type	Treasury code

AccountIdentification object

Field	Type	Required	Description
accountNumber	string	✅	Account number / IBAN
accountCurrencyCode	string	✅	Account currency ISO code

Money object

Field	Type	Required	Description
amount	number	✅	Amount. Must be greater than 0
currency	string	✅	Currency ISO code

Transfer Types

TransferType	Description
TransferToOwnAccount	Transfer between own accounts
TransferWithinBank	Transfer to another account within TBC Bank
TransferToOtherBankNationalCurrency	Transfer to another bank in national currency
TransferToOtherBankForeignCurrency	Transfer to another bank in foreign currency
TreasuryTransfer	Treasury transfer
TreasuryTransfer instead of 3rd person	Treasury transfer on behalf of a third person

Response Parameters

The response contains the processing result for each transfer order individually, based on its position (index) in the request.

ℹ️
The API returns HTTP 207 Multi-Status instead of 201 Created, allowing both successful and failed transfer orders to be returned within the same response.

ℹ️
For each rejected transfer order, the response includes:

the order index within the request;

the validation error code;

the validation error description, explaining why the transfer order was rejected.

⚠️
If a request contains 10 transfer orders and only 2 fail validation, those 2 transfer orders will be rejected, while the remaining 8 valid transfer orders will be successfully submitted to Internet Banking.

Field	Type	Description
succeed	array / SingleTransferResult	Orders that passed validation and were pushed through to internet banking
failed	array / FailedSingleTransferResult	Orders that were rejected by validation

SingleTransferResult object

Field	Type	Description
position	integer	Position provided in the request
transferId	integer	Internal ID of the single transfer created in the bank's system

FailedSingleTransferResult object

Field	Type	Description
position	integer	Position provided in the request
errors	array / string	Validation reasons the order failed on

Rules

Rule	Description
singleTransferOrders is required	The array must be filled and must not be empty
Maximum 10 orders	A maximum of 10 single transfer orders can be sent in one request
transferExternalId uniqueness	If provided, it must be unique within the request
Duplicated request	If a single transfer request has already been received with the same requestId, a business error is returned
position logic	If position is provided for one order, it must be provided for all orders
position uniqueness	position must be unique and greater than 0
description	Maximum length - 140 characters
additionalDescription	Maximum length - 210 characters
TreasuryTransfer	Must be in GEL and a 9-digit treasuryCode must be provided
TransferToOtherBankForeignCurrency	Beneficiary details and chargeDetails are required; allowed values: SHA, OUR

Request / Response Examples

{
    "singleTransferOrders": [
        {
            "transferType": "TransferWithinBank",
            "transferExternalId": "269011",
            "documentNumber": 10001,
            "position": 1,
            "debitAccount": {
                "accountNumber": "GE41TB7849963286076183",
                "accountCurrencyCode": "GEL"
            },
            "amount": {
                "amount": 10,
                "currency": "GEL"
            },
            "description": "Transfer Within Bank",
            "additionalDescription": "Test transfer",
            "creditAccount": {
                "accountNumber": "GE44TB0600051509630891",
                "accountCurrencyCode": "GEL"
            }
        },
        {
            "transferType": "TransferToOwnAccount",
            "transferExternalId": "606905",
            "documentNumber": 10001,
            "position": 2,
            "debitAccount": {
                "accountNumber": "GE61TB7625533660958046",
                "accountCurrencyCode": "GEL"
            },
            "amount": {
                "amount": 20,
                "currency": "GEL"
            },
            "description": "Transfer To Own Account",
            "additionalDescription": "Test transfer",
            "creditAccount": {
                "accountNumber": "GE67TB7441135534174413",
                "accountCurrencyCode": "GEL"
            }
        },
        {
            "transferType": "TransferToOtherBankNationalCurrency",
            "transferexternalId": "209511",
            "documentNumber": 10002,
            "position": 3,
            "debitAccount": {
                "accountNumber": "GE61TB7625533660958046",
                "accountCurrencyCode": "GEL"
            },
            "amount": {
                "amount": 30,
                "currency": "GEL"
            },
            "description": "National currency transfer",
            "additionalDescription": "Test transfer to other bank",
            "creditAccount": {
                "accountNumber": "GE90BG0000000589021505",
                "accountCurrencyCode": "GEL"
            },
            "beneficiaryName": "Test Beneficiary",
            "beneficiaryTaxCode": "12345678901"
        }
    ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TransferToOwnAccount",
      "transferExternalId": "12345",
      "documentNumber": 10001,
      "position": 1,
      "debitAccount": {
        "accountNumber": "GE61TB7625533660958000",
        "accountCurrencyCode": "GEL"
      },
      "amount": {
        "amount": 3.45,
        "currency": "GEL"
      },
      "description": "Own account transfer",
      "additionalDescription": "Test transfer",
      "creditAccount": {
        "accountNumber": "GE41TB7849963286076000",
        "accountCurrencyCode": "GEL"
      }
    }
  ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TransferWithinBank",
      "transferExternalId": "12345",
      "documentNumber": 10001,
      "position": 1,
      "debitAccount": {
        "accountNumber": "GE61TB7625533660958000",
        "accountCurrencyCode": "GEL"
      },
      "amount": {
        "amount": 125.50,
        "currency": "GEL"
      },
      "description": "Transfer within TBC Bank",
      "additionalDescription": "Invoice payment",
      "creditAccount": {
        "accountNumber": "GE44TB0600051509630000",
        "accountCurrencyCode": "GEL"
      },
      "beneficiaryName": "Test Company LLC",
      "beneficiaryTaxCode": "204567891"
    }
  ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TransferToOtherBankNationalCurrency",
      "transferExternalId": "12345",
      "documentNumber": 10002,
      "position": 1,
      "debitAccount": {
        "accountNumber": "GE61TB7625533660958000",
        "accountCurrencyCode": "GEL"
      },
      "amount": {
        "amount": 100,
        "currency": "GEL"
      },
      "description": "National currency transfer",
      "additionalDescription": "Test transfer to other bank",
      "creditAccount": {
        "accountNumber": "GE90BG0000000589021000",
        "accountCurrencyCode": "GEL"
      },
      "beneficiaryName": "Test Beneficiary",
      "beneficiaryTaxCode": "12345678901"
    }
  ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TransferToOtherBankForeignCurrency",
      "transferExternalId": "12345",
      "debitAccount": {
        "accountNumber": "GE71TB7530433617684000",
        "accountCurrencyCode": "EUR"
      },
      "documentNumber": 0,
      "amount": {
        "amount": 1,
        "currency": "EUR"
      },
      "position": 1,
      "description": "Test transfer",
      "additionalDescription": "Postman test",
      "creditAccount": {
        "accountNumber": "CZ6508000000192000145000",
        "accountCurrencyCode": "EUR"
      },
      "beneficiaryName": "Beneficiary Name",
      "beneficiaryAddress": "Beneficiary Address",
      "beneficiaryBankCode": "0800",
      "beneficiaryBankName": "Czech Bank",
      "intermediaryBankCode": "string",
      "intermediaryBankName": "string",
      "chargeDetails": "SHA"
    }
  ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TreasuryTransfer",
      "transferExternalId": "12345",
      "documentNumber": 10001,
      "position": 1,
      "debitAccount": {
        "accountNumber": "GE61TB7625533660958000",
        "accountCurrencyCode": "GEL"
      },
      "amount": {
        "amount": 1,
        "currency": "GEL"
      },
      "description": "Treasury payment",
      "additionalDescription": "Test treasury transfer",
      "treasuryCode": "101001000"
    }
  ]
}

{
  "singleTransferOrders": [
    {
      "transferType": "TreasuryTransfer",
      "transferExternalId": "12345",
      "documentNumber": 10001,
      "position": 1,
      "debitAccount": {
        "accountNumber": "GE61TB7625533660958000",
        "accountCurrencyCode": "GEL"
      },
      "amount": {
        "amount": 1,
        "currency": "GEL"
      },
      "description": "Treasury payment",
      "additionalDescription": "Test treasury transfer",
      "taxpayerCode": "123456789",
      "taxpayerName": "Test Taxpayer",
      "treasuryCode": "101001000"
    }
  ]
}

{
    "succeeded": [
        {
            "position": 1,
            "transferId": 412
        },
        {
            "position": 2,
            "transferId": 413
        },
        {
            "position": 3,
            "transferId": 414
        }
    ],
    "failed": []
}