Import Single Transfer

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

A maximum of 10 single transfer orders can be sent in one request.

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

Endpoint

GET /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

Field	Type	Description
singleTransferResults	array / SingleTransferResult	Results of created single transfers

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

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": "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"
    }
  ]
}

{
  "singleTransferResults": [
    {
      "position": 1,
      "transferId": 19827
    }
  ]
}