Import single transfer orders

post

https://test-api.tbcbank.ge/bab/v1/transfers/single

Creates one or several single transfer orders in the bank system.
A single request may contain up to 10 single transfer orders,
passed in the singleTransferOrders array.

The type of each order is defined by the transferType field:

`transferType`	Description
`TransferToOwnAccount`	Transfer between the client's 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 (GEL only, requires 9-digit `treasuryCode`)

Field requirements by transfer type

Field	`TransferToOwnAccount`	`TransferWithinBank`	`TransferToOtherBankNationalCurrency`	`TransferToOtherBankForeignCurrency`	`TreasuryTransfer`
`creditAccount`	Required	Required	Required	Required	Not used
`description`	Required	Required	Required	Required	Required
`beneficiaryName`	—	Required	Required	Required	—
`beneficiaryAddress`	—	—	—	Required	—
`beneficiaryBankCode`	—	—	—	Required	—
`chargeDetails`	—	—	—	Required (`SHA`/`OUR`)	—
`taxpayerCode`	—	—	—	—	Required
`taxpayerName`	—	—	—	—	Required
`treasuryCode`	—	—	—	—	Required (9 digits)

Validation rules

singleTransferOrders must be provided and must not be empty.
Maximum 10 orders per request.
If transferExternalId is provided, it must be unique within the request.
A duplicated request (same transferExternalId already received) returns a business error.
If position is provided for one order, it must be provided for all orders and must be unique and greater than 0.
description maximum length: 140 characters.
additionalDescription maximum length: 210 characters.
accountNumber must be in a valid format.
accountCurrencyCode must be a valid ISO currency code.
Currency exchange may be restricted depending on transfer type.
TreasuryTransfer must be in GEL and include a 9-digit treasuryCode.
For TransferToOtherBankForeignCurrency: beneficiary details and chargeDetails are required. Allowed chargeDetails values: SHA, OUR.

Body Params

singleTransferOrders

array of objects

required

length between 1 and 10

List of single transfer orders. Must not be empty. Maximum number of orders per request: 10.

singleTransferOrders*

A single transfer order within a request.

transferType

string

enum

required

Transfer type. Determines which additional fields are required.

Allowed:

transferExternalId

integer

External transfer ID assigned by the client system. Used for duplicate control and for later transfer ID lookup via GET /bab/v1/transfers/single/{transferExternalId}. If provided, must be unique within the request.

documentNumber

integer

Document number for the transfer order.

position

integer

Order position in the request. Used to match response results to request orders. If provided for one order, it must be provided for all orders and must be unique and greater than 0.

debitAccount

object

required

Account number and currency used for debit or credit account identification.

creditAccount

object

Account number and currency used for debit or credit account identification.

amount

object

required

Amount and currency for a transfer order.

description

string

length ≤ 140

Payment description / purpose. Required for all transfer types. Maximum length: 140 characters.

additionalDescription

string

length ≤ 210

Additional description. Optional. Maximum length: 210 characters.

beneficiaryName

string

Beneficiary name. Required for TransferWithinBank, TransferToOtherBankNationalCurrency, and TransferToOtherBankForeignCurrency.

beneficiaryTaxCode

string

Beneficiary tax / identification code. Optional.

beneficiaryAddress

string

Beneficiary address. Required for TransferToOtherBankForeignCurrency.

beneficiaryBankCode

string

Beneficiary bank BIC/SWIFT or local bank code. Required for TransferToOtherBankForeignCurrency.

beneficiaryBankName

string

Beneficiary bank name. Optional.

intermediaryBankCode

string

Intermediary bank BIC/SWIFT code. Optional.

intermediaryBankName

string

Intermediary bank name. Optional.

chargeDetails

string

enum

Fee charge detail for foreign currency transfers to other banks. Required for TransferToOtherBankForeignCurrency. Allowed values: SHA (shared charges), OUR (sender pays all charges).

Allowed:

taxpayerCode

string

Taxpayer identification / tax code. Required for TreasuryTransfer.

taxpayerName

string

Taxpayer name. Required for TreasuryTransfer.

treasuryCode

string

^\d{9}$

Treasury code. Required for TreasuryTransfer. Must be exactly 9 digits.

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

HTTP status	Code	Description
400	`ValidationError`	One or more validation errors occurred. Request body, query parameter, or specific field is invalid.
400	`DUPLICATED_SINGLE_TRANSFER_REQUEST`	The same single transfer request (same `transferExternalId`) has already been received/registered.
400	`VALIDATION_ERROR`	Business validation failed, for example the debit account is not assigned to the client.
400	`DomainError`	Business/domain validation failed.

HTTP status	Code	Description
500	`SystemError`	A system error occurred while processing the request.
500	`ApplicationError`	An application logic error occurred.

Language

Credentials

Bearer

JWT

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

200Transfer orders created successfully.

401Unauthorized. The access token is missing, invalid, or expired.

500Server Error. Possible error codes: HTTP statusCodeDescription500SystemErrorA system error occurred while processing the request.500ApplicationErrorAn application logic error occurred.